[カスタム構成] タブでは、エージェントの機能やサンプリングポリシーなどの共通設定を調整できます。
ARMS API を使用してこれらの設定を構成する方法については、「SaveTraceAppConfig」をご参照ください。
前提条件
アプリケーションにエージェントがインストールされていること。詳細については、「アプリケーション監視の概要」をご参照ください。
機能へのアクセス
ARMS コンソールにログインします。左側のナビゲーションウィンドウで、を選択します。
上部のナビゲーションバーで、 を選択します。
カスタムパラメーターを設定し、[保存] をクリックします。
サンプリング設定
[サンプリング設定] セクションでは、トレースのサンプリングポリシーを設定できます。Go アプリケーションは、固定レートサンプリングのみをサポートします。また、インターフェイス名、プレフィックス、またはサフィックスに基づいてフルサンプリングを設定することもできます。
エージェントスイッチ設定
[エージェントスイッチ設定] セクションでは、アプリケーション監視を有効化または無効化し、さまざまなプラグインのスイッチを設定できます。
アプリケーション監視の有効化または無効化の変更は、アプリケーションを再起動しなくてもすぐに有効になります。アプリケーション監視を一時停止すると、ご利用のアプリケーションは監視されなくなります。操作には十分ご注意ください。
プラグインスイッチの変更は、アプリケーションを再起動した後に有効になります。
ランタイムスイッチ設定
[ランタイムスイッチ設定] セクションでは、ランタイムモニタリングを有効化または無効化できます。詳細については、「ランタイムモニタリング」をご参照ください。
この変更は、アプリケーションを再起動しなくてもすぐに有効になります。ランタイム監視を無効にすると、ARMS はランタイムメトリックを収集しなくなります。操作には十分ご注意ください。
アプリケーションログ関連付け設定
[アプリケーションログ関連付け設定] セクションでは、アプリケーションのログソースを設定して、対応するログに `SpanId` と `TraceId` を追加できます。詳細については、「Go アプリケーションのビジネスログとトレース ID の関連付け」をご参照ください。
ログに書き込まれる `trace_id` および `span_id` フィールドのキーを変更できます。
URL 収束設定
[URL 収束設定] セクションでは、収束機能を有効または無効にしたり、収束しきい値と収束ルールを設定したりできます。 URL 収束は、類似した URL をグループ化し、単一のアイテムとして表示します。 たとえば、/service/demo/ で始まる URL は、単一のグループとして表示されます。 収束しきい値は、収束がトリガーされる前にルールに一致する必要がある URL の最小数を指定します。 たとえば、しきい値を 100 に設定した場合、100 個の URL が指定された正規表現に一致した後にのみ、収束が発生します。 詳細については、「ARMS 収束メカニズム」をご参照ください。
継続的プロファイリング設定
[継続的プロファイリング設定] セクションでは、メインスイッチ、CPU ホットスポット、メモリホットスポット、コードホットスポットの各機能を有効または無効にできます。詳細については、「Go アプリケーションの継続的プロファイリング」をご参照ください。
インターフェイス呼び出し設定
[インターフェイス呼び出し設定] セクションでは、低速呼び出しのしきい値、HTTP ステータスコードのホワイトリスト、無効なインターフェイス呼び出しフィルターを設定できます。
低速呼び出しのしきい値：単位は ms です。デフォルト値：500。リクエストの応答時間がしきい値を超えると、そのリクエストは低速としてマークされます。
HTTP ステータスコードのホワイトリスト：
デフォルトでは、400 より大きい HTTP ステータスコードはエラーと見なされます。特定のステータスコードをエラーと見なしたくない場合は、ホワイトリストに追加できます。
この設定は、「アプリケーション監視でサポートされている HTTP フレームワーク」にのみ影響します。
影響を受けるデータ：HTTP サーバーとクライアントのエラー数メトリック (arms_http_requests_error_count、arms_http_client_requests_error_count、arms_app_requests_error_count)、およびスパンステータス。
影響を受ける機能：[概要]、[提供サービス]、および [依存関係] タブのエラー数、ならびに [トレースエクスプローラー] ページのスパンステータスとエラー数に関連するアラート。
内容のフォーマット：単一のステータスコードを入力します。複数のステータスコードはコンマ (,) で区切ります。あいまい一致はサポートされていません。
例：
403,502デフォルト値：空
無効なインターフェイス呼び出しのフィルタリング：
[提供されたサービス] タブで特定の呼び出しを表示したくない場合は、名前を入力してフィルターできます。エージェントはこれらのインターフェイスのモニタリングデータを報告しなくなり、インターフェイス呼び出しページで非表示になります。
影響を受けるデータ：指定されたインターフェイスのすべてのメトリックとスパンは無視されます。
影響を受ける機能: 指定されたインターフェイスに関する、[概要]、[提供サービス]、および [依存関係] タブ上のすべてのメトリック、ならびに [トレースエクスプローラー] ページ上のスパン、呼び出し、エラー、および低速呼び出しのアラート。
内容のフォーマット：文字列または AntPath 式を使用して、無効なインターフェイスのフルネームに一致させます。複数のルールはコンマ (,) で区切ります。デフォルト値の AntPath 式は、既存データとの互換性のためのものです。削除しないでください。新しいルールは既存のルールの後に追加してください。
例：
/api/test/*,/api/playground/createデフォルト値：
/**/*.jpg,/**/*.png,/**/*.js,/**/*.jpeg,/**/*.pdf,/**/*.xlsx,/**/*.txt,/**/*.docs,/**/*.gif,/**/*.csvHTTP リクエストボディの出力を有効化：有効にすると、HTTP クライアントのスパンに `http.request.body` フィールドが追加され、リクエストボディが含まれます。デフォルトの長さは 1024 文字です。
HTTP リクエストヘッダーの出力を有効化：有効にすると、HTTP クライアントのスパンに `http.request.header` フィールドが追加され、リクエストヘッダーが含まれます。
HTTP ボディの長さ：収集する HTTP リクエストボディの最大長を指定します。デフォルトの長さは 1024 文字です。
HTTP レスポンスに TraceId を含める：有効にすると、`TraceId` がレスポンスヘッダーに追加されます。ヘッダーのキーは `Eagleeye-TraceId` です。
HTTP レスポンスボディの出力を有効化：有効にすると、HTTP サーバーのスパンに `http.response.body` フィールドが追加され、レスポンスボディが含まれます。
HTTP レスポンスヘッダーの出力を有効化：有効にすると、HTTP サーバーのスパンに `http.response.header` フィールドが追加され、レスポンスヘッダーが含まれます。
HTTP レスポンスボディの長さ：収集する HTTP レスポンスボディの最大長を指定します。デフォルトの長さは 1024 文字です。
HTTP リクエストヘッダーのキーをスパンに書き込む：記録したいヘッダーフィールドのキーを入力します。複数のキーはコンマ (,) で区切ります。この設定を行うと、HTTP クライアントのスパンに `http.request.header.key` フィールドが追加されます。
HTTP レスポンスヘッダーのキーをスパンに書き込む：記録したいヘッダーフィールドのキーを入力します。複数のキーはコンマ (,) で区切ります。この設定を行うと、HTTP サーバーのスパンに `http.response.header.key` フィールドが追加されます。
データベース呼び出し設定
[データベース呼び出し設定] セクションでは、低速 SQL 文のしきい値と、収集される SQL 文の最大長を設定できます。また、SQL 文に変数バインディング値と定数値を表示するかどうかを指定することもできます。
SQL の変数バインディング値を表示：`PreparedStatement` パラメーターにバインドされた変数の値をキャプチャします。この変更は、アプリケーションを再起動しなくてもすぐに有効になります。
SQL の定数値を表示：追加の処理を行わずに、生の SQL 文を表示します。この変更は、アプリケーションを再起動しなくてもすぐに有効になります。
トレース伝播プロトコル設定
[トレース伝播プロトコル設定] セクションでは、要件に基づいてトレースプロトコルを選択できます。デフォルトのプロトコルは W3C です。Zipkin、Jaeger、または EagleEye を選択することもできます。
エージェント収集設定
[エージェント収集設定] セクションでは、エージェントが 1 秒あたりに収集できるトレースの最大数と、エージェントのログレベルを設定できます。
以下にいくつかのパラメーターを説明します：
カスタムメトリック収集：コード内の OpenTelemetry (OTel) SDK で定義されたメトリックをエージェントが収集するかどうかを指定します。
スパンレポートの有効化：この機能はデフォルトで有効になっています。無効にすると、スパンはレポートされません。
スパンレポート名：スパンレポートを無効にした場合でも、レポートしたいスパンの名前を指定できます。
カスタムメトリック収集設定：メトリックのスコープ名を設定します。この設定を行わない場合、デフォルトですべてのカスタムメトリックが収集されます。
詳細設定
[詳細設定] セクションでは、分位数統計、エラーと低速のサンプリング、および例外スタックの最大長を設定できます。
アプリケーション設定を他のアプリケーションにコピー
あるアプリケーションの設定を他のアプリケーションにコピーできます。
単一の設定項目を他のアプリケーションにコピー
設定項目のセクションで、[保存して他のアプリケーションに一括コピー] をクリックします。
「現在の設定は保存されていません」というメッセージが表示された場合は、[保存] をクリックして設定を保存し、再度 [保存して他のアプリケーションに一括コピー] をクリックします。
表示されるダイアログボックスで、特定のアプリケーションまたは他のすべてのアプリケーションを選択し、[OK] をクリックします。
すべての設定項目を他のアプリケーションにコピー
ページの下部で、[保存して他のアプリに一括コピー] をクリックします。
「現在の設定は保存されていません」というメッセージが表示された場合は、[保存] をクリックして設定を保存し、再度 [保存して他のアプリケーションに一括コピー] をクリックします。
表示されるダイアログボックスで、特定のアプリケーションまたは他のすべてのアプリケーションを選択し、[OK] をクリックします。
アプリケーション設定をグローバルに適用
現在のアプリケーション設定をグローバルに適用できます。新しいアプリケーションを作成すると、この設定がデフォルトで使用されます。
ページの下部で、[現在のアプリ設定をグローバルデフォルト構成として保存] をクリックします。
「現在の設定は保存されていません」というメッセージが表示された場合は、[保存] をクリックして設定を保存し、再度 [現在のアプリ設定をグローバルデフォルト構成として保存] をクリックします。
表示されるメッセージで、[OK] をクリックします。