アラート管理

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

PagerDuty統合、エスカレーションポリシー、アラートルーティング、インシデント調整を備えた高度なアラート管理システムを設計・実装します。

使用場面

• アラートルーティングの設定
• オンコール体制管理
• インシデント対応の調整
• エスカレーションポリシーの作成
• 警告システムの統合

クイックスタート

最小限の動作例：

// pagerduty-client.js
const axios = require("axios");

class PagerDutyClient {
  constructor(apiToken) {
    this.apiToken = apiToken;
    this.baseUrl = "https://api.pagerduty.com";
    this.eventUrl = "https://events.pagerduty.com/v2/enqueue";

    this.client = axios.create({
      baseURL: this.baseUrl,
      headers: {
        Authorization: `Token token=${apiToken}`,
        Accept: "application/vnd.pagerduty+json;version=2",
      },
    });
  }

  async triggerEvent(config) {
    const event = {
      routing_key: config.routingKey,
      event_action: config.eventAction || "trigger",
      dedup_key: config.dedupKey || `event-${Date.now()}`,
      payload: {
        summary: config.summary,
// ... (詳細な実装についてはリファレンスガイドを参照してください)

リファレンスガイド

references/ ディレクトリに詳細な実装例があります：

ガイド	内容
PagerDuty Client Integration	PagerDuty Client統合
Alertmanager Configuration	Alertmanager設定
Alert Handler Middleware	アラートハンドラーミドルウェア
Alert Routing Engine	アラートルーティングエンジン
Docker Compose Alert Stack	Docker Composeアラートスタック

ベストプラクティス

✅ すべきこと

• 適切なしきい値を設定する
• アラート重複排除を実装する
• わかりやすいアラート名を使用する
• ランブックリンクを含める
• エスカレーションを適切に設定する
• アラートルールをテストする
• アラート品質を監視する
• リピート間隔を設定する
• アラートメトリクスを追跡する
• アラートの意味を文書化する

❌ してはいけないこと

• あらゆる異常でアラートを出す
• アラート疲れを無視する
• しきい値を恣意的に設定する
• ランブックをスキップする
• 対応しないアラートを出す
• 本番環境でアラートを無効化する
• 曖昧なアラート名を使用する
• エスカレーションポリシーを忘れる
• アラートを頻繁に再発行する