Expvar (Go)

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

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

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

メリット

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

メトリクスを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードの詳細については、「Splunk Observability Cloudでダッシュボードを表示する」を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他リソースのデータ駆動型の視覚化を表示します。ナビゲータの詳細については、「Splunk Infrastructure Monitoring でナビゲーターを使用する」を参照してください。
Metric Finder へアクセスし、モニターから送信されたメトリクスを検索します。詳細は、「メトリクス・ファインダーとメタデータ・カタログを検索する」を参照してください。

インストール

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

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
- 「Collector でSmart Agent モニターを使用する」を参照してください。
- Smart Agent レシーバーの設定方法を参照してください。
- 一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
- Collector の詳細については、「はじめに：Collector を理解して使用する」を参照してください。

例

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

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

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

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 の設定方法を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______