Mackerel blog #mackerelio

The Official Blog of Mackerel

Specific metrics can now be specified when sharing graphs etc.

Hello, Mackerel Team Director Kasuya (id:daiksy) here.

We’ve always made our weekly feature announcements from this blog on Friday, but this week we’re publishing on Thursday.

Last week, participants from the Hatena Summer Internship Program joined the Mackerel development team and started working on feature development. Tomorrow is the last day for our interns and each team will make a presentation to show what they’ve accomplished.

So, this week we’re announcing our new features one day early in preparation for the interns’ presentations tomorrow.

All new features announced this week will be those that the interns have worked on with support from the development team!

Anyways, here is this week’s update information.

Specific metrics can now be specified when posting graphs to notification channels

Up until now, sharing a graph with Mackerel’s graph posting feature meant displaying all metrics included in that graph. For example, even if you only wanted to discuss memory.used trends, you could only share a graph that displayed all the memory metrics

With this update, graphs can now be shared with specific metrics selected in the host metric graph.

The screenshot below shows graphs with only memory.used selected shared in Slack.

And of course, the permalink for this shared graph will also only have memory.used selected.

Notification channels are now displayed in the log of the alert details screen

All channels to which notifications will be sent are now displayed for each log in the alert details screen.

There are three types of icons to verify the notification status; one to show that the notification was successful, one for failed and currently re-sending, and one to show that the notification attempted to re-send the specified number of times, but failed.

Alerts can now be filtered by monitor rule in the alert list

“Monitor rule” has been added as a condition to filter alerts in the alert list.

For example, now it’s easier to do things like display a list of only closed check monitoring alerts and obtain an application’s rate of operation or narrow the list down to external monitoring alerts only and check the Web application status.

When manually closing alerts, the closer and the reason for closing can now be noted

In the notification for when an alert is closed manually, the person who closed the alert and the reason for closing it can now be noted.

With this, now you can get a better understanding of the manual closing without having to go the the alert details screen.

Upcoming Mackerel events

The Mackerel team is working hard to create opportunities like events and booths where we can meet all our users.

September 21st AWS Cloud Roadshow 2017 Osaka

Mackerel is sponsoring the AWS Cloud Roadshow in Osaka on September 21st. Be sure to stop by if you’re in the area! !

AWS Cloud Roadshow 2017 大阪 powered by Intel® 広島、大阪、名古屋、福岡の 4 都市を巡る無料クラウドカンファレンス開催! | アマゾン ウェブ サービス (Japanese only)

September 26th Drinkup Osaka

Mackerel’s Drinkup event has often been held in Tokyo, but this month it’s being held in Osaka.

I’m looking forward to seeing all of you in the Kansai area!

The namespace list can now be obtained with the metadata API etc.

Hello, Mackerel Team Director Kasuya (id:daiksy) here.

Here at Hatena, it wouldn’t feel like summer without our summer internship program. And this year’s new interns are fitting right in.

Hatena Summer Intership 2017 (Japanese only)

Starting this week, the student interns who’ve finished the first half lecture part of their internship have each been assigned to various teams and are trying their hands at feature development. I’m excited to see what features they’ll release this year.

By the way, here are features developed by the student interns who were assigned to the Mackerel team last year.

Anyways, here is this week’s update information.

The namespace list can now be obtained with the metadata API

An API to obtain the namespace list of metadata registered to the host has been implemented in the metadata API.

Combining this with the metadata acquisition API makes it easier to manage the information registered to the host.

Check out the help page below for more information.

By the way, this is a feature implemented by this year’s interns under the support of our development team! !

Log levels have been changed for when metric posting fails in mackerel-agent

Up until now, if metric posting in mackerel-agent failed, it was output as an error in the agent’s log. However, the failed posting would be retried and, unless the agent stopped, posted to Mackerel without losing any data.

For this reason, we’ve changed the log level to Warning.

Other updates for mackerel-agent and mackerel-agent-plugins are as follows.

mackerel-agent 0.44.2

  • Log levels changed for when when metric posting fails
  • Linux/MIPS CPU/SoC model name is now displayed in host details

mackerel-agent-plugins 0.31.1

  • [redis] the method to obtain queries metrics was corrected
  • [plack] errors no longer occur when JSON parsing fails
  • [jmx-jolokia] obtain metrics for Jmx Threading graph added

Mackerel at AWS Cloud Roadshow Osaka

Mackerel will be sponsoring and running a booth at the AWS Cloud Roadshow Osaka to be held on September 21st. Drop by if you’re in the area!!

AWS Cloud Roadshow 2017 大阪 powered by Intel® 広島、大阪、名古屋、福岡の 4 都市を巡る無料クラウドカンファレンス開催! | アマゾン ウェブ サービス (Japanese only)

A new feature, “GraphBoards” has been released! etc.

Hello! Mackerel team’s CRE Inoue (id:a-know) here.

Last Saturday, Mackerel successfully held its’ first Hackathon event, Mackerel Plugin Hackathon #1.

Anyways, here is this week’s update information.

A new feature, “GraphBoards” has been released!

With this update, we’ve released a new feature called “GraphBoards”!

So what does this feature do?

This feature is like dashboards, you can select any role graph or service metrics graph of that service and freely rearrange the layout. It’s ideal for users who have numerous roles or are using a lot of service metrics.

It’s also possible to create a more intuitive layout just by dragging and dropping!

Use of the automatic update feature and switching between display intervals is possible for any of the arranged graphs without having to change to another screen.

Check out the help page below for information on how to create and configure GraphBoards.

Notes attached to monitoring rules are now included in the body of mail notifications

For monitoring rules created in Mackerel, you can leave notes such as “If this alert goes off, check —— first” or “If —– or —— occurs, this alert will occur”.

Display for the content of these notes in alert notifications is already supported with some channels such as Slack and HipChat, but with this update, the note content is now also included in the body of mail notifications. We believe that this will help make troubleshooting smoother than before.

Updates for mackerel-agent and more

mackerel-agent v0.44.1

  • Minor corrections were made.

mackerel-agent-plugins v0.30.0

  • mackerel-plugin-openldap was newly added.
  • [aws-ec2-ebs] Burst Balance metrics were added.

go-check-plugins v0.12.0

  • check-disk plugin was newly added.
  • [postgresql] The database name can now be specified with the database option.

mkr v0.17.0

  • [dashboards] unit and title parameter support was added for expression graphs

Mackerel User Group Meeting Vol.3

The Mackerel User Group, a group of Mackerel user volunteers successfully held their third event, the Mackerel User Group Meeting Vol.3, on Wednesday, August 23rd!

On the day of, Lightning Talk consisted of presentations about useful tools and even a Mackerel game! It sounds like the event got pretty exciting.

Here are a few reports written by those who participated! (Japanese only)

For those of you who unfortunately couldn’t make it this time, please join us at the next User Group Meeting!

Mackerel at CEDEC 2017 August 30th - September 1st

Mackerel is scheduled to run a booth at CEDEC 2017 from Wednesday to Friday next week.

The event will be held at Pacifico Yokohama. We will be exhibiting on the third floor of the venue. Additionally, Sone (id:Soudai) , Mackerel CRE, will be speaking in the session “Enjoyable performance monitoring with Mackerel”.

If you’re planning on attending the event, definitely stop-by our booth!

Member invitations can now be canceled with the API etc.

Up until the middle of this week, our support window took some time off for the summer holidays (except for emergencies), but they’re back at it now. Sorry for any inconvenience and we appreciate your cooperation.

Anyways, here is this week’s update information.

Member invitations can now be canceled with the API

Using the invitation API, you can invite members to an organization by specifying an email address, but with this week’s update you can now cancel invitations with the API.

Up until now, it was only possible to cancel invitations from the Web UI, but now the same operation can be done from the API. You can also use it when you want to re-invite a member with different permissions. By all means, try it out.

For details regarding how to use the API, check out the help page below.

Date and time of the latest update can now be obtained with the metadata API

Various information can be registered to the host using the metadata API, and now you can obtain the date and time of its latest update.

% curl --dump-header -<host_id>/metadata/<namespace> -H "X-Api-Key: <API_KEY>"
HTTP/1.1 200 OK
Last-Modified: Sat, 01 Jul 2017 13:25:08 GMT

For more regarding the metadata API, check out the below help page.

About the second stage of maintenance on Monday (8/21)

This is another announcement regarding the second stage of our platform transition maintenance which will be carried out early next week from 2: 30 - 3: 30 p.m. (JST) on Monday, August 21st, 2017.

This will be the last stage of scheduled maintenance related to this platform transition. Your cooperation is appreciated. Please see the entry below for details.

A book on Mackerel coming soon!

A book on Mackerel will be released on the 26th of this month!

This book isn’t just about how to use Mackerel, it also talks about the basics of server monitoring and serves as an introduction to infrastructure management. By all means, take a look!

Mackerel User Group Meeting Vol.3 coming soon!

We made an announcement about this in a previous blog post, but the event is almost here! The “Mackerel User Group”, a group put together by volunteer Mackerel users, is holding their next event, Mackerel User Group Meeting Vol. 3!

Even though this is a User Group event, id:Soudai and id:Songmu, CRE and sub-producer of the Mackerel team are scheduled to take the stage!

On top of that, this event has a line up of presentations that are sure to be really interesting, so you’ll definitely want to join us!

Regarding stage 2 maintenance on 8/21(Mon.)

Mackerel sub-producer id:Songmu here.

The first stage of maintenance was carried out this week on Monday, August 7th. As previously announced, in continuation with this maintenance, the second stage will take place on Monday, August 21st.

This time, only relocation of the subsystems will be done and since the database and such will not be relocated, service will not be stopped.

With this, maintenance related to this platform transition will come to an end. Your cooperation is appreciated.

Although mentioned in the entry below, we’ll take you through the details again.

Date and time

Monday, August 21, 2017 2:30 - 3:30 p.m. (JST)


The URL external monitoring, AWS integration, and Azure integration subsystems will be relocated.

Extent of impact

There will be no stoppage of service. However, there is a possibility that monitoring with the above-mentioned subsystems may occasionally stop working.

After maintenance is completed, the source IP address used for notification channels from Mackerel such as URL external monitoring, AWS integration, Azure integration, and Webhook will be changed. Email notifications will not change.

Additionally, in regards to URL monitoring, it’s possible that measured response time trends may fluctuate slightly in order to for the observation conditions, including location, to change.

For users who are subject to IP address restrictions, please add the new IP address in addition to the current IP address to the transmission permission targets by the maintenance date.

※Due to the possibility that rollbacks may occur after maintenance is completed, please keep the current IP address concurrently for a few months. We will make a separate announcement regarding deletion of the current IP address.

Current IP address


New IP address


Regarding announcements on the day of

Announcements will be made from our Status Page (

We’ll be making occasional status update announcements from the status page. In the unlikely event that maintenance should be extended, we will inform you from the status page.

In addition, after maintenance is completed, we will update our blog with details including actual times of implementation.

For inquiries regarding this matter please email us at

Thank you for your cooperation and thank you for choosing Mackerel.

Maintenance completion notice + an apology in relation to data loss and custom dashboard/expression monitoring failures

I’m id:Songmu, Mackerel’s sub-producer. Previously announced maintenance began today (Monday, August 8th) at 2:30 p.m. (JST) and was completed at 6:00 p.m. Thank you to all our users for your cooperation.

In this entry, we’ll report on some of the details related to this event. All the times listed below will be in Japan Standard Time.

Period of no-access

The entire system was inaccessible from 2:30-2:50 p.m. as well as 3:30-3:33 p.m.

Regarding data loss

During maintenance, an unexpected loss of data occurred and we sincerely apologize for any inconvenience this may have caused.

Data created in the Mackerel database during the time of 2:30-3:31 p.m. excluding times series data, was lost. Specifically, data including alert and host information registered during the above time period was lost.

Regarding the cause of the incident and our response

The cause of this incident was due to an unintended database failover during the time of maintenance. Data was lost from the start of maintenance until when the failover occurred. Originally, preventative measures were taken so that data would not be lost if a failover occurred, but failed due to a unique circumstance while work was in-progress.

Attempts were made to recover said data, but due to difficulty in maintaining consistency with the data updated after failover, the recovery was abandoned.

After the failover, we carefully reexamined the redundant configuration of the database and made sure that a similar problem would not occur. Technical details regarding this matter will be posted at another time.

Regarding work requests for hosts registered during the period of data loss

Hosts that were newly registered with mackerel-agent during the above mentioned time period (2:30-3:31 p.m.) can not post data correctly. We’re sorry for the inconvenience, but please re-register the host.

Specifically, delete the id file ( /var/lib/mackerel-agent/id ), then restart mackerel-agent.

Regarding custom dashboard failures (fixed 8/8)

Graph display problems have occurred for custom dashboards created or updated since the start of maintenance. This issue is scheduled to be fixed by Tuesday, August 8th.

(Fixed 8/8) Corrections were complete with this release on Tuesday, August 8th.

Regarding expression monitoring failures (fixed 8/8)

We have confirmed the occurrence of expression monitoring failures in several organizations after the maintenance. We sincerely apologize, but we are unable to respond immediately. Individual announcements will be made to the owners of the respective organizations.

(Fixed 8/8) Corrections were made and the situation resolved with this release on Tuesday, August 8th.

Again, we apologize for any inconvenience this may have caused our users. We are committed to further improving our quality of service in the future and we thank you for your patience and appreciate your continued use of Mackerel.

It’s now possible to leave an organization etc.

It’s August! And like we announced last week, Hatena has entered a new term. On July 31st, a company-wide meeting was held and all members of the Mackerel team got together.

We also added some new members to the team! Get ready for even more development!

Anyways, here is this week’s update information.

It’s now possible to leave an organization

Up until now, in order to leave an organization that you belong to, action from a user with administrator authority was necessary. Now we’ve made it possible to do this on your own.

This operation can be performed from the account screen’s organization tab.

Updates for Mackerel-agent-plugins and cookbook-mackerel-agent

mackerel-agent-plugins has been updated to v0.29.1, and cookbook-mackerel-agent has been updated to v1.3.0.


  • [accesslog] Log format detection logic improved
  • [solr] graph definitions improved


  • Enabled to specify environment variable
  • Other minor modifications made to README etc.

A big thanks to everyone who contributed to the above repository!

First stage of large-scale maintenance starts Monday of next week (8/7)

We’ve talked about the large-scale maintenance scheduled for August in previous blog announcements, and now the time has come. The first stage of maintenance starts next Monday, August 7th.

Below are the entries with detailed information regarding the maintenance. Be sure to take another look.

Mackerel UG Meeting vol.3 scheduled for 8/23 (Wed.)

The Mackerel User Group was put together by a group of Mackerel user volunteers. This will be the group’s third event, to be held on Wednesday, August 23rd.

The theme for this event is XaaS meets Mackerel so it should be a good opportunity to hear about interesting and useful manners of application! A few of the Mackerel team staff are planning to stop by as well. I hope you can join us!

Notice for Obon holiday【8/11(Fri.)- 8/16(Wed.)】

The Mackerel team will be out of the office from August 11th (Friday) until August 16th (Wednesday) for the Obon national holiday. During this period, we will be taking a break from our weekly update blog and the support window (except for emergencies).

Our next update blog entry will be on Friday, August 18th. Have a great summer vacation everyone!