Application Real-Time Monitoring Service (ARMS) エージェントは、一般的なフレームワークとメソッドを自動的にインスツルメントします。ご利用のアプリケーションがカスタムビジネスロジックまたはサポートされていないフレームワークを使用している場合、一部のメソッドがトレースデータに表示されないことがあります。これらの検出されないメソッドをトレース内でキャプチャするには、カスタムメソッドを追加します。コード変更は不要です。
カスタムメソッドを追加するタイミング
次のような状況でカスタムメソッドを追加します。
モニタリングする必要があるメソッドが、ARMS エージェントによって自動的にインスツルメントされない場合。
注文処理や支払い処理など、特定のビジネスロジックに対してよりきめ細かな可視性が必要な場合。
トレースデータに、内部メソッド呼び出しに十分な詳細がないギャップが表示される場合。
メソッドが サポートされているフレームワーク に属しているにもかかわらずトレースに表示されない場合は、カスタムメソッドとして追加する前に、ARMS エージェントが正しくインストールおよび設定されていることを確認してください。
前提条件
開始する前に、以下を確認してください。
アプリケーション用にインストールされた ARMS エージェントです。詳細については、「アプリケーションモニタリングの概要」をご参照ください。
アプリケーションモニタリングは、新しい課金モードを有効にしたユーザー向けに、新しいアプリケーション詳細ページを提供します。詳細については、「課金 (新規)」をご参照ください。新しい課金モードを有効にしていない場合は、[アプリケーション一覧] ページで [新バージョンに切り替え] をクリックすると、新しいアプリケーション詳細ページにアクセスできます。
カスタムメソッドの追加
ARMS コンソールにログインします。ARMS コンソール の左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーション一覧] を選択します。
「アプリケーション一覧」ページで、上部のナビゲーションバーからリージョンを選択し、管理するアプリケーションの名前をクリックします。
説明[言語] 列に
アイコンが表示されている場合、アプリケーションはアプリケーションモニタリングに接続されています。 ハイフン ([-]) が表示されている場合、アプリケーションは OpenTelemetry 向けマネージドサービスに接続されています。上部ナビゲーションバーで、 を選択します。
[方法の追加] をクリックします。
「[カスタムメソッドの追加]」ダイアログボックスで、以下のパラメーターを設定し、[OK] をクリックします。
説明同じ呼び出しスタック内で複数のカスタムメソッドをエントリポイントとしてマークした場合、ARMS はチェーン内の最後のメソッドのモニタリングデータのみを収集します。たとえば、関数 A が関数 B を呼び出し、両方がエントリポイントとして設定されている場合、ARMS は関数 B のモニタリングデータのみを収集します。
パラメーター
説明
メソッド
モニタリングするメソッドの名前。メソッド名は一意である必要があります。
有効化
このメソッドのモニタリングを有効または無効にします。有効にすると、メソッドはトレースデータ内のローカルメソッドスタックに表示されます。詳細については、「トレースクエリ」をご参照ください。デフォルトで有効です。この機能は、アプリケーションを再起動せずに有効または無効にできます。
コールエントランス
このメソッドをリクエストトレースのエントリポイントとしてマークします。有効にすると、トレースによってビジネスをクエリでき、対応するインターフェイスが[提供されたサービス]タブに表示されます。詳細については、「提供されるサービス」をご参照ください。デフォルトで無効になっています。
結果の確認
カスタムメソッドを追加した後:
トレースのクエリと分析 を行い、カスタムメソッドがトレースデータに表示されていることを確認します。
「呼び出しエントランス」を有効にした場合は、「提供されるサービス」[タブ]を確認して、エントリーメソッドが一覧表示されていることを確認します。