Announcements

#mackerelio

【Advance Release Notice】Change to Mackerel API error response, and more

Hello, This is Igarashi (id:masarasi), a CRE on the Mackerel team.

Here are the details of this update:

【Advance Release Notice】Change to Mackerel API Error Response

The Mackerel API error response currently uses different error response formats for each endpoint. This new change will implement one single format across all endpoints in order to make the API easier to use.

Change Details

From December 6th, 2022 onward, the response format returned by the Mackerel API when there is an error will be changed as shown below, making it common across all endpoints. Please note that no changes have been made to other responses, such as success responses.

Current format

{
  "error": "foo"
}

Or

{
  "error": {
    "message": "foo"
}

Common single format after the change

{
  "error": {
    "message": "foo"
  }
}

Scope of Change

Official Client Library This new change is aimed at customers who are using proprietary programs that execute the Mackerel API directly without using (mackerel-client-go, mackerel-client-ruby), and who make use of the body in error responses. This change will not impact any customers who only use the mackerel-agent or official plug-ins.

Affected customers are requested to amend their programs to reflect this new change in the error response format.

We thank you in advance for your kind understanding with regard to the new change outlined above. If you have any queries or concerns, please contact our support team.

Improved Accessibility

  • Improved keyboard and assistive technology usability of the edit widget modal window on the custom dashboard.
  • The outline is now visible when the focus is on the Back button (<) on edit screens, etc.
  • The outline is now visible when the focus is on the notification channel or notification group, in the notification target list of the notification channel edit screen. - In the list of monitoring rules, notification channels, etc., the edit button, etc. used to be displayed only when the mouse hovered over them. Now they are also displayed when they have the focus.

Bug Fixes

  • Fixed issue of failing external monitoring calls sent to servers that support only TLS 1.0 (issue between approximately 12pm and 3pm on October 19th, 2022).
  • RFC8996 states that the use of TLS 1.0 and TLS 1.1 is not recommended. Hence, we plan to terminate their support for external monitoring in the future.
  • Fixed issue of abnormal values being obtained by EBS metrics through mackerel-plugin-aws-ec2-ebs in AWS Nitro EC2 instances.