zPagesエクステンション

zPagesエクステンションを使用して、さまざまなコンポーネントをデバッグするためのライブデータを提供するHTTPエンドポイントであるzPagesを提供するエクステンションをアクティブにします。

zPagesエクステンションはzPagesを提供します。zPagesはHTTPエンドポイントで、様々なコンポーネントをデバッグするためのライブデータを提供します(適切にインストルメンテーションされている場合)。

すべてのコア・エクスポーターとレシーバーは、いくつかのZPageインストルメンテーションを提供しています。

はじめに

注: このコンポーネントは、ホスト監視(エージェント)モードでデプロイする場合、Splunk Distribution of the OpenTelemetry Collector のデフォルト設定に含まれます。詳細については、「Collector deployment modes」を参照してください。デフォルト設定について詳しくは「Helm で Collector for Kubernetes を設定する」、「Collector for Linux のデフォルト設定」、または「Collector for Windows のデフォルト設定」を参照してください。このドキュメントで説明されているように、いつでも設定をカスタマイズできます。

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:

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

  2. このドキュメントで説明されているように、エクステンションを設定します。

  3. Collector を再起動します。

サンプル構成

これはエクステンションの設定例です:

YAML
extensions:
  zpages:
    endpoint: "localhost:55679"

設定を完了するには、設定ファイルの service セクションに拡張子を含めます:

YAML
service:
  extensions: [zpages]

エクステンションの設定には以下の設定が必要です:

  • endpointします。zPages を提供する HTTP エンドポイントを指定します。

    • デフォルトでは localhost:55679 です。

    • ZPagesエクステンションをローカルでのみ使用できるようにするには、localhost: を使用します。

    • すべてのネットワーク・インターフェイスでZPages拡張を利用できるようにするには、":" を使用します。

設定」のセクションで、公開されている設定の全リストを参照してください。

公開されたzPagesルート

Collector は以下の zPage ルートを公開します:

ServiceZ

ServiceZ は Collector サービスの概要を提供し、pipelinez、extensionz、featurez zPages にすばやくアクセスできます。このページでは、ビルド情報とランタイム情報も提供します。

たとえば、http://localhost:55679/debug/servicez

PipelineZ

PipelineZ は、Collector で実行中のアクティブなパイプラインに関する情報を提供します。タイプ、データの変異の有無、各パイプラインで使用されているレシーバー、プロセッサ、エクスポータに関する情報を確認できます。

たとえば、http://localhost:55679/debug/pipelinez

ExtensionZ

ExtensionZ は Collector でアクティブな拡張機能を表示します。

たとえば、http://localhost:55679/debug/extensionz

FeatureZ

FeatureZは、利用可能な機能ゲートを、現在のステータスと説明とともに一覧表示します。

たとえば、http://localhost:55679/debug/featurez

TraceZ

TraceZ ルートは、0us、10us、100us、1ms、10ms、100ms、1s、10s、1m といったレイテンシのバケットごとにスパンを調査し、ソートします。また、エラーサンプルを素早く調べることもできます。

たとえば、http://localhost:55679/debug/tracez

RpcZ

Rpczルートは、gRPCのように適切にインストルメンテーションされたリモート・プロシージャ・コール(RPC)の統計を調べるのに役立ちます。

たとえば、http://localhost:55679/debug/rpcz

設定

次の表に、zPages 拡張の設定オプションを示します:

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/extension/zpages.yaml

トラブルシューティング

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.