Expvar (Go)

Golang Expvar モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

Splunk Distribution of OpenTelemetry Collector は、Smart Agent レシーバを expvar モニタータイプで使用して、公開された Expvar をスクレイピングします。詳細については、「expvar」を参照してください。

このインテグレーションでは、設定されたパスを使用して、HTTP エンドポイントで取得された JSON オブジェクトからメトリクス値とディメンション値を取得します。このドキュメントの「メトリクス」セクションでは、memstats expvar 変数から派生したメトリクスを示します。これらの memstat メトリクスは、標準またはデフォルトのメトリクスと呼ばれ、デフォルトで公開されます。

メリット

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

インストール

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

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

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

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

設定

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

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

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

例

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

YAML 
receivers:
  smartagent/expvar:
    type: expvar
    ... # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

YAML 
service:
  pipelines:
    metrics:
      receivers: [smartagent/expvar]

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

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

オプション

必須

タイプ

説明

host

yes

string

expvarエンドポイントのホスト

port

yes

integer

expvarエンドポイントのポート

useHTTPS

いいえ

bool

 true の場合、エージェントは HTTPS を使用してホストに接続します。

プレーン HTTP の代わりに HTTPS を使用します。（デフォルト： false）

skipVerify

いいえ

bool

 useHTTPS が true で、このオプションも true である場合、

ホストの TLS 証明書は検証されません。（デフォルト： false）

path

いいえ

string

 expvarのエンドポイントへのパスで、通常は /debug/vars （

デフォルト）。（デフォルト： /debug/vars）

enhancedMetrics

いいえ

bool

 true の場合、メトリクス memstats.alloc、

memstats.by_size.size、memstats.by_size.mallocs および memstats.by_size.frees を送信します（デフォルト： false）

metrics

いいえ

list of objects (see below)

メトリクスの設定

ネストされた metrics コンフィギュレーションオブジェクトには以下のフィールドがあります。

オプション

必須

タイプ

説明

name

いいえ

string

メトリクス名

JSONPath

yes

string

メトリクス値のJSONパス

type

yes

string

 SignalFx メトリクスタイプ。使用可能な値は "gauge" または

“cumulative” です

dimensions

いいえ

list of objects (see below)

メトリクスディメンション

pathSeparator

いいえ

string

 JSONオブジェクト内のメトリクス値のパス区切り文字

（デフォルト： .）

ネストされた dimensions コンフィギュレーションオブジェクトには以下のフィールドがあります。

オプション

必須

タイプ

説明

name

yes

string

ディメンション名

JSONPath

いいえ

string

ディメンション値の JSON パス

value

いいえ

string

ディメンション値

メトリクス

memstats メトリクスはデフォルトで提供される標準メトリクスであるため、モニターを構成しないでください。このインテグレーションでは、以下のメトリクスも使用できます。

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/expvar/metadata.yaml

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

  • ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、「その他のメトリクスの追加」で extraMetrics の設定方法を参照してください。

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.