Search By Category

Regarding scheduled maintenance

Any scheduled maintenance that involves a suspension of the Mackerel service will be announced in advance through the following methods:

Regarding newsletters, all users registered in Mackerel will be sent a notification regardless of their notification email settings, so please be sure to check.

Impact of Maintenance

During maintenance, the Mackerel system will be temporarily suspended, which may affect some or all of the following states. Please check the announcement for each scheduled maintenance for the actual scope of impact.

  • The following will become unavailable:
    • Web access to Mackerel
    • Submission of metrics and check monitoring results by the agent
    • Submission of labeled metrics by the OpenTelemetry Collector
    • API access (including CLI tools)
    • Starting the agent (startup will fail because communication with the main Mackerel system cannot be established)
  • External monitoring and cloud integration graphs may have missing data corresponding to the maintenance period.
  • Alerts will not be generated.
  • Trace issues will not be created.
  • Estimated trace usage metrics will not be posted. Posting will resume after maintenance is complete.

Buffering and Resending Data During Maintenance

  • Metrics and check monitoring results collected by the agent are buffered on the agent side and resent after maintenance is complete.
    • If resent successfully, graphs will also be displayed for the maintenance period.
  • Labeled metrics submitted by the OpenTelemetry Collector are not buffered, but it is possible to use the metric submission retry setting to repost metrics that fail to post.
  • During maintenance, metric submissions to Mackerel will fail, and corresponding error messages indicating the failure will be output to the error logs.
  • It is possible to submit trace data during maintenance, but it will be reflected sequentially after maintenance is complete. Please note that this does not guarantee that data submission will be completed successfully.

Alert Behavior After Maintenance

  • If a metric exceeds the monitoring threshold during maintenance and then falls below the threshold, no alert will be generated after maintenance is complete.
  • Check monitoring alerts that occurred during maintenance will be sent out all at once after maintenance is complete, covering up to 6 hours of alerts.
    • The alert occurrence and recovery times are the times posted to Mackerel.

Operations Requiring Caution

  • Please note that restarting or stopping the agent before resending is complete will result in the loss of buffered data.
  • Please note that restarting or stopping the OpenTelemetry Collector before metric submission is complete will result in the loss of data held for metric submission.

Related articles