Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » SignalFx Smart Agent から Splunk Distribution of OpenTelemetry Collector への移行 » モニターの共通設定

モニターの共通設定 🔗

以下の設定オプションはすべてのモニターに共通で、Collector では Smart Agent レシーバー を使用して使用できます:

設定オプション

デフォルト

必須

タイプ

説明

type

いいえ

string

モニターの種類

discoveryRule

いいえ

string

この設定を検出されたエンドポイントにマッチさせるために使用されるルール。空白の場合、エージェントの起動時に設定が直ちに実行されます。複数のエンドポイントがこのルールに一致する場合、異なるホストまたはポートを除いて、同じ設定でモニタータイプの複数のインスタンスが作成されます。

validateDiscoveryRule

false

いいえ

bool

true の場合、ディスカバリールールに、ルールにマッチする可能性のない変数が含まれていると、警告が発せられます。複数のオブザーバーを使用する場合、スプリアスエラーを抑制するために、これを false に設定します。これが設定されていない場合、トップレベルの設定 validateDiscoveryRules がデフォルトとして動作します。

extraDimensions

いいえ

map of strings

この設定から作成されたモニター(複数可)が出力するデータポイントに含める、追加のディメンション(キーと 値のペア)のセット。このモニターからのメトリクスが高解像度であることを指定するには、ディメンション sf_hires: 1 を追加します。

extraSpanTags

いいえ

map of strings

この設定から作成されたモニターが発するスパンに含める、追加のスパンタグ(キーと値のペア)のセット。

extraSpanTagsFromEndpoint

いいえ

map of strings

余分なスパンタグ名と、スパンタグの値を導出するために使用されるディスカバリールール式とのマッピング。例えば、特定のコンテナ・ラベルをスパンタグとして使用するには、extraSpanTagsFromEndpoint: {env: 'Get(container_labels, "myapp.com/environment")'} のようなものを使用します。 これは、モニターが discoveryRule を持っているか、エンドポイントによって動的にインスタンス化された場合にのみ適用されます。

defaultSpanTags

いいえ

map of strings

この設定から作成されたモニターが発するスパンに含めるデフォルトのスパンタグ(キーと値のペア)のセット。

defaultSpanTagsFromEndpoint

いいえ

map of strings

デフォルトのスパンタグ名と、スパンタグのデフォルト値を導出するために使用されるディスカバリールール式とのマッピング。例えば、特定のコンテナ・ラベルをスパンタグとして使用するには、defaultSpanTagsFromEndpoint: {env: 'Get(container_labels, "myapp.com/environment")'} のようなものを使用します。 これは、モニターが discoveryRule を持っているか、エンドポイントによって動的にインスタンス化された場合にのみ適用されます。

extraDimensionsFromEndpoint

いいえ

map of strings

ディメンションの値の導出に使用される、ディスカバリールール式への余分なディメンション名のマッピング。例えば、特定のコンテナ・ラベルをディメンションとして使用するには、extraDimensionsFromEndpoint: {env: 'Get(container_labels, "myapp.com/environment")'} のようなものを使用します。 これは、モニタに discoveryRule があるか、エンドポイントによって動的にインスタンス化された場合にのみ適用されます。

configEndpointMappings

いいえ

map of strings

このモニター上の設定オプションから、発見されたエンドポイントの属性へのマッピングのセット。キーはこのモニター上の設定オプションで、値は発見ルールで使用される有効な式です。

intervalSeconds

0

いいえ

integer

この設定によって作成されたモニターからデータポイントを出力する間隔 (秒単位)。設定されていない(または0に設定されている)場合、代わりにグローバルエージェントのintervalSeconds設定オプションが使用されます。

solo

false

いいえ

bool

1つまたは複数の設定でこの設定が true になっている場合、それらの設定のみが考慮されます。この設定はテストに便利です。

datapointsToExclude

いいえ

list of objects

データポイントフィルターのリスト。これらのフィルターを使用すると、メトリクス名またはディメンションセットによって除外するデータポイントを包括的に定義できるほか、オーバーライドを定義して、同じフィルター項目 内の以前のパターンによって除外されたメトリクスを再度含めることもできます。

disableHostDimensions

false

いいえ

bool

一部のモニターは、同じホスト上で動作していないサービスからメトリクスを取得するため、ホスト固有のディメンションが設定されるべきではありません(例えば、hostAWSUniqueId など)。これを true に設定すると、これらのディメンションが省略されます。これをグローバルに無効にするには、設定の最上位レベルにある disableHostDimensions オプションを使用します。

disableEndpointDimensions

false

いいえ

bool

オブザーバーによって検出されたエンドポイントに固有のディメンションを含めない場合は、true を設定できます。これは、他のメトリクスのプロキシまたはアダプタとして主に動作するため、識別が特に重要でないエンドポイントがある場合に便利です。

metricNameTransformation

いいえ

map

元のメトリクス名から置換値へのマップ。キーは正規表現として解釈され、値は後方参照を含むことができるので、元のメトリクス名のRE文字を \ でエスケープします。ピリオドはエスケープされていないと「すべての文字」と解釈されるため、ピリオドには `` .`` を使用してください。Go正規表現言語では、後方参照は $1 という形式になります。マップのリストに複数のエントリがある場合は、それぞれ順番に実行され、前のエントリの変換を次の変換の入力として使用します。モニターから出力されるすべてのメトリクスに共通の接頭辞を追加するには、(.*): myprefix.$1 のようなマッピングを使用します。

dimensionTransformations

いいえ

map of strings

モニターから出力されるディメンション名から、Splunk Observability Cloud に送信されるデータポイントで出力される希望のディメンション名へのマップ。これは、アプリケーションからのカスタムメトリクスがあり、モニターからのディメンションをそれらと一致させたい場合に便利です。また、フリーフォームのメトリクスをスクレイピングする場合にも便利です。

extraMetrics

いいえ

list of strings

デフォルトで含まれているメトリクス以外に有効にする追加メトリクス。これはオーバーライド可能なフィルターです。

extraGroups

いいえ

list of strings

デフォルトで出力されるメトリクスに加えて、有効にする追加のメトリクスグループ。メトリクスグループは、単にメトリクスの集まりで、各モニターのドキュメントで定義されています。

このページは 2024年04月18日 に最終更新されました。