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 のデフォルト設定」を参照してください。このドキュメントで説明されているように、いつでも設定をカスタマイズできます。

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

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
このドキュメントで説明されているように、エクステンションを設定します。
Collector を再起動します。

サンプル構成

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

extensions:
  zpages:
    endpoint: "localhost:55679"

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

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

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

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