Docs » Splunk Observability Cloud でサポートされているインテグレーション » データベースのアプリケーション・レシーバーを設定する » Exec 入力

Exec 入力 🔗

Splunk Distribution of OpenTelemetry Collector は、Telegraf Exec プラグインの組み込み型である Exec Input モニタータイプで Smart Agent レシーバー を使用して、exec ファイルからメトリクスやログを受信します。

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

  1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

  2. [設定] セクションの説明に従ってインテグレーションを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/exec:
    type: telegraf/exec
    ...  # Additional config

次に、イベント提出要求を行うエクスポーターを利用する logs パイプラインにモニターを含めます。リソース検出プロセッサーを使用して、ホストIDと他の有用な情報がイベント・ディメンションとして利用できるようにします。例：

service:
  pipelines:
    logs:
      receivers:
        - smartagent/exec
      processors:
        - resourcedetection
      exporters:
        - signalfx

コンフィギュレーション設定 🔗

以下の表に、このモニタータイプの設定オプションを示します：

オプション

必須

タイプ

説明

commands

いいえ

list of strings

command

いいえ

string

timeout

いいえ

int64

デフォルト値は 0 です。

telegrafParser

いいえ

object (see below)
telegrafParser はネストされたオブジェクトで、

Telegrafパーサーの設定を定義します。Telegraf パーサーの詳細については、Telegraf ドキュメントを参照してください。

signalFxCumulativeMetrics

いいえ

list of strings
Splunk Observability Cloud で 「累積カウンター」 として入力されたメトリクス名の

Splunk Observability Cloud. The Telegraf Exec plugin only emits untyped metrics, which are sent as gauges by default.

ネストされた telegrafParser コンフィギュレーション・オブジェクトは以下のフィールドを持ちます：

オプション

必須

タイプ

説明

dataFormat

いいえ

string
dataFormatは解析するデータ形式を指定します： json,

value、 influx、graphite、 value、nagios、collectd、dropwizard、wavefront、grok、csv、 または logfmt。デフォルト値は influx です。

defaultTags

いいえ

map of strings
defaultTags は、すべてのメトリクスに追加されるタグです。( json、value 、

graphite、collectd、dropwizard、wavefront、grok、csv および logfmt のみ)

metricName

いいえ

string
metricName は ( json と value ) に適用されます。これは

測定の名前です。

dataType

いいえ

string
dataTypeは、値を

integer、float、long、string、または boolean に対して解析する値の型を指定します。 ( value のみ)

JSONTagKeys

いいえ

list of strings

JSONデータから取得するタグ名のリスト。( json のみ)

JSONStringFields

いいえ

list of strings
抽出し、文字列フィールドとして使用するJSONのフィールドのリスト。

(jsonのみ)

JSONNameKey

いいえ

string
JSONデータのメトリクス名を抽出するためのパス。( json

のみ)

JSONQuery

いいえ

string

jsonパーサ用のgjsonパス。( json のみ)

JSONTimeKey

いいえ

string

タイムスタンプキーの名前。( json のみ)

JSONTimeFormat

いいえ

string

タイムスタンプのフォーマットを指定します。( json のみ)

separator

いいえ

string

グラファイトデータ用セパレータ。( graphite のみ）。

templates

いいえ

list of strings

Graphiteデータのテンプレート一覧。( graphite のみ）。

collectdAuthFile

いいえ

string

collectd 認証ファイルへのパス ( collectd のみ )

collectdSecurityLevel

いいえ

string
セキュリティ・レベルを指定します： none （デフォルト）、sign 、または

encrypt。 ( collectd only )

collectdTypesDB

いいえ

list of strings

collectd TypesDB ファイルのパスのリスト。( collectd のみ)

collectdSplit

いいえ

string
多値メトリクススを分離するか結合するかを指定します。

( collectd のみ)

dropwizardMetricRegistryPath

いいえ

string
JSONデータの内側にあるメトリクスレジストリを見つけるために使用するオプションの gjson パス。

デフォルトの動作は、JSONドキュメント全体を考慮します。( dropwizard のみ)

dropwizardTimePath

いいえ

string
ドロップウィザードのメトリクスタイムスタンプを識別するためのオプションのgjsonパス。

( dropwizard のみ)

dropwizardTimeFormat

いいえ

string
ドロップウィザードのメトリクスタイムスタンプの解析に使用されるフォーマット。

デフォルトの書式は time.RFC3339。（ dropwizard のみ）

dropwizardTagsPath

いいえ

string
ドロップ・ウィザード・タグを見つけるために使われるオプションのgjsonパス。

( dropwizard のみ)

dropwizardTagPathsMap

いいえ

map of strings
JSONドキュメントからタグ値を抽出するために使われるgjsonタグ名とgjsonパスのマップ。

これは、dropwizardTagsPath が指定されていない場合にのみ使用されます。( dropwizard のみ)

grokPatterns

いいえ

list of strings

一致するパターンのリスト。( grok のみ)

grokNamedPatterns

いいえ

list of strings

一致する名前付き grok パターンのリスト。( grok のみ)

grokCustomPatterns

いいえ

string

カスタムグロックパターン。( grok のみ)

grokCustomPatternFiles

いいえ

list of strings

カスタム grok パターンファイルへのパスのリスト。( grok のみ)

grokTimezone

いいえ

string
タイムゾーンを指定します。デフォルトはUTC時間です。その他のオプション

は、Local はマシンのローカルタイム、UTC、および Canada/Eastern （unixスタイルのタイムゾーン）です。( grok のみ)

CSVDelimiter

いいえ

string

csvのフィールド間で使用される区切り文字。( csv のみ)

CSVComment

いいえ

string

行をコメントとしてマークするための文字。( csv のみ)

CSVTrimSpace

いいえ

bool
フィールドから先頭の白を取り除くかどうかを示します。( csv

のみ） デフォルト値は false です。

CSVColumnNames

いいえ

list of strings
カスタム列名のリスト。すべての列に名前が必要です。

名前のない列は無視されます。このコンフィギュレーションは、CSVHeaderRowCount が 0 の時に設定されなければなりません。( csv のみ)

CSVColumnTypes

いいえ

list of strings
列に割り当てる型のリスト。使用可能な値は

int、float、bool、または string です ( csv のみ)。

CSVTagColumns

いいえ

list of strings
タグとして追加される列のリスト。未指定の列は

フィールドとして追加されます。( csv のみ)

CSVMeasurementColumn

いいえ

string
メトリクス名を抽出する列の名前 ( csv

のみ)

CSVTimestampColumn

いいえ

string
メトリクスのタイムスタンプを抽出する列の名前。

このオプションを使用する場合は、必ず CSVTimestampFormat を設定してください。( csv のみ)

CSVTimestampFormat

いいえ

string

タイムスタンプの抽出に使用するフォーマット。( csv のみ)

CSVHeaderRowCount

いいえ

integer
ヘッダーの行数。デフォルトでは行は

ヘッダーとして扱われません。( csv のみ) デフォルト値は 0 です。

CSVSkipRows

いいえ

integer
ヘッダーを探す前に無視する行数。

( csv のみ) デフォルト値は 0 です。

CSVSkipColumns

いいえ

integer
指定された行でデータを解析する前に無視する列の数。

( csv のみ) デフォルト値は 0 です。

メトリクス 🔗

By default metrics are emitted as gauges.

If you have cumulative counter metrics that you want properly typed in Splunk Observability Cloud, use one of the following options:

  • 設定オプション signalFxCumulativeCounters に、カウンターとして考慮するメトリクス名のリストを設定します。これらの名前は Splunk Observability Cloud に送信されるフルネームであることに注意してください (たとえば、<metric>.<field> )。

  • execスクリプトによって生成されたメトリクスの signalfx_type というタグを cumulative に設定します。他の値はすべて無視されます。パーサーが特定のフィールドを無視する場合、パーサーのコンフィギュレーション でこのタグ値を許可しなければならないことに注意してください。例えば、JSONパーサーは JSONTagKeys コンフィギュレーションオプションに signalfx_type を追加する必要があります。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

This page was last updated on 2024年05月31日.