モニターの共通設定

モニターの一般的な構成設定。

以下の設定オプションはすべてのモニターに共通で、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] に設定します。この設定は、主に他のメトリクスのプロキシまたはアダプタとして機能するため、ID が特に重要ではないエンドポイントに対して有用です。

metricNameTransformation

いいえ

map

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

dimensionTransformations

いいえ

map of strings

モニターが出力するディメンション名から、Splunk Observability Cloud に送信されるデータポイントで出力される目的のディメンション名へのマップ。このマップは、アプリケーションのカスタム指標がある場合に、モニターからのディメンションをそれらに一致させる場合に役立ちます。また、自由形式のメトリクスをスクレイピングする場合にも役立ちます。

extraMetrics

いいえ

list of strings

デフォルトで含まれるメトリクスに加えてイネーブルにする追加メトリクス。これは上書き可能なフィルタです。

extraGroups

いいえ

list of strings

デフォルトで出力されるメトリクスに加えてイネーブルにする追加のメトリクスグループ。メトリクスグループは単なるメトリクスのコレクションであり、各モニターのドキュメントで定義されています。