AppDynamicsでカスタムイベントとカスタムアラートを監視

はじめに

このドキュメントでは、REST APIを使用してAppDynamicsでカスタムイベントを設定し、自動アラート用の正常性ルールに接続する方法について説明します。

前提条件

• AppDynamics SaaSまたはオンプレミスコントローラインスタンスへのアクセス
• イベント、正常性ルール、およびポリシーを作成および管理するためのアクセス許可
• コントローラバージョン21.x以降
• 通知チャネル（電子メール、SMS、またはサードパーティ製品との統合）の設定
• REST APIとAppDynamicsユーザーインターフェイスの基本的な知識
  
  

要件

開始する前に、次の要件を満たしていることを確認してください。

• AppDynamics Controllerバージョン21.x以降（最新のイベントおよびアラート機能用）
• コントローラに対して有効なREST APIアクセス
• アラート配信用に構成された通知チャネル（電子メール、SMS、または統合）
  
  

使用するコンポーネント

• AppDynamicsコントローラー
• AppDynamicsエージェント
• 通知チャネル

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

ますます動的になるクラウドネイティブアーキテクチャの世界では、システムの復元力を確保し、平均解決時間(MTTR)を短縮するために、予防的なモニタリングが不可欠です。 AppDynamicsは、カスタムイベントやアラートを作成する機能など、堅牢な監視機能を提供します。これらの機能は、運用チームが異常をより迅速に検出し、正確に対応するために役立ちます。

すぐに使えるメトリックは重要ですが、現代のシステムではコンテキスト固有の可観測性が必要になることがよくあります。CI/CDパイプライン、カスタムオートメーションツール、または外部システムのいずれを統合する場合でも、AppDynamicsにカスタムイベントを挿入すると、以下が保証されます。

• システムおよびビジネスのメトリック全体にわたる統合された可視性
• アプリケーション固有の異常をリアルタイムで検出
• 自動化されたアクションにより、手動による介入を削減

アプリケーションの特定の側面を監視するカスタムイベントを作成することが適切な場合もあります。この記事では、AppDynamicsコントローラーのREST APIを使用してカスタムイベントを作成する方法と、カスタムイベントに基づいてアラートを設定する方法について説明します。

設定

このセクションでは、カスタムイベントを作成し、AppDynamics Controllerでアラートを設定する手順を説明します。

コンフィギュレーション

ステップ1:REST APIを使用したカスタムイベントの作成

カスタムイベントは、AppDynamics REST APIを使用して生成できます。これは、外部システム、カスタムスクリプト、自動化フレームワーク、またはサードパーティ製ツールの統合に役立ちます。

API呼び出しの例：

POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application

主要なパラメータ:

• <controller-url>と<application_id>は実際のコントローラの詳細に置き換えてください。
• 必須パラメータ:
  • 重大度（情報、警告、エラー）
  • 概要（簡単な説明）
  • eventtype （CUSTOMである必要があります）
  • customeventtype （カスタムイベントタイプラベル）
  • comment（オプションの詳細メッセージ）
    
    

要求に成功すると、作成を確認するイベントIDが返されます

例：「Successfully created the event id:550346816」

可視性のヒント：挿入されたイベントを表示するには、イベントUIでカスタムフィルタを有効にすることを忘れないでください。

ステップ2：カスタムイベントのフィルタリングとモニタリング

• コントローラのUIで、Eventsセクションに移動します。
• イベントタイプまたはプロパティを追加するには、「Filter by Custom Events」を使用します。
  • より詳細なフィルタリングを行うために、キー/値ペアを指定できます。
  • ANDロジックにはAllを使用します（すべてのプロパティが一致する必要があります）。ORロジックにはAnyを使用します（少なくとも1つのプロパティが一致します）。
    
    

これにより、アプリケーション全体でインジェクトされたイベントをターゲットを絞って追跡および調査できます。

ステップ3：アラートの設定：アクションおよびポリシー

Actions：

• カスタムイベント（電子メールの送信、sms、webhookの呼び出しなど）がトリガーされたときに何が起こるかを指定します。
  
  

ポリシー:

• 新しいポリシーを作成するか、既存のポリシーを編集します。
  
  
• ポリシーで、定義したカスタムイベントに一致するようにカスタムイベントフィルタを設定します。
  
  

• ポリシーのアクションタブで、新しいアクションを追加し、作成したカスタムアクションを選択します。
• アラートを保存します。アラートを設定したら、Saveをクリックして作成します。

アラートを作成すると、指定した条件に一致するカスタムイベントがコントローラで生成されるたびにトリガーされます。 

確認

• REST APIを使用してテストカスタムイベントを投稿します。
  
• Events UIで可視性を確認します（フィルタをチェック）。
  
  
• カスタムイベントに対してアクションがトリガーされることを検証します。

• 設定された通知チャネルを介した配信を検証します。

トラブルシュート

結論

AppDynamicsのカスタムイベントとアラートは、監視戦略を強化する強力な方法を提供します。CI/CDツールや外部サービスとの統合、主要なワークフローの可視化の拡張など、これらの機能により、ユーザに影響が及ぶ前に問題を迅速に検出して解決できます。 カスタムの可観測性インテリジェンスの活用を開始して、モニタリングをリアクティブから予測的に向上させます。

さらなる支援が必要

質問がある場合や問題が発生している場合は、AppDynamicsサポートに連絡して、エラーメッセージ、構成情報、関連ログなどの詳細を含めることで、トラブルシューティングを迅速に進めることができます。

関連情報

• イベントの監視
• アラートと応答