Docs » Get started with the Splunk Distribution of the OpenTelemetry Collector » Collector components » zPages extension

zPages extension 🔗

The zPages extension serves zPages, an HTTP endpoint that provides live data for debugging different components, if they were properly instrumented for such. zPages are useful for in-process diagnostics without having to depend on any backend to examine traces or metrics.

All core exporters and receivers provide some zPage instrumentation.

Get started 🔗

The following settings are required to configure the extension:

  • endpoint. Specifies the HTTP endpoint that serves zPages.

    • localhost:55679 by default.

    • Use localhost: to make the ZPages extension available only locally.

    • Use ":" to make the ZPages extension available on all network interfaces.

See the full list of exposed settings in the section Settings.

Sample configurations 🔗

This is a configuration example for the extension:

extensions:
  zpages:
    endpoint: "localhost:56888"

Exposed zPages routes 🔗

The Collector exposes the following zPage routes:

ServiceZ 🔗

ServiceZ gives an overview of the Collector services, and provides quick access to the pipelinez, extensionz, and featurez zPages. The page also provides build and runtime information.

For example, http://localhost:55679/debug/servicez .

PipelineZ 🔗

PipelineZ brings insight on the active pipelines running in the Collector. You can find information on type, whether data is mutated, and the receivers, processors and exporters that are used for each pipeline.

For example, http://localhost:55679/debug/pipelinez .

ExtensionZ 🔗

ExtensionZ shows the extensions that are active in the Collector.

For example, http://localhost:55679/debug/extensionz .

FeatureZ 🔗

FeatureZ lists the feature gates available along with their current status and description.

For example, http://localhost:55679/debug/featurez .

TraceZ 🔗

The TraceZ route examines and sorts spans by latency buckets like 0us, 10us, 100us, 1ms, 10ms, 100ms, 1s, 10s, or 1m. They also allow you to quickly examine error samples.

For example, http://localhost:55679/debug/tracez .

RpcZ 🔗

The Rpcz route helps examine statistics of remote procedure calls (RPCs) that are properly instrumented, such as gRPC.

For example, http://localhost:55679/debug/rpcz .

Settings 🔗

The following table shows the configuration options for the zPages extension:

Troubleshooting 🔗

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 #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

To learn about even more support options, see Splunk Customer Success .