Skip to main content

​
Opencensus Exporter

Status Source: opentelemetry-collector-contrib

​
Overview

Status
Stabilitybeta
Supported pipeline typestrace, metrics
Distributionscontrib
Exports traces and/or metrics via gRPC using OpenCensus format.

​
Getting Started

The following settings are required:
  • endpoint (no default): host:port to which the exporter is going to send Jaeger trace data, using the gRPC protocol. The valid syntax is described here
By default, TLS is enabled and must be configured under tls::
  • insecure (default = false): whether to enable client transport security for the exporter’s connection.
As a result, the following parameters are also required under tls::
  • cert_file (no default): path to the TLS cert to use for TLS required connections. Should only be used if insecure is set to false.
  • key_file (no default): path to the TLS key to use for TLS required connections. Should only be used if insecure is set to false.
Example: 
exporters:
  opencensus:
    endpoint: opencensus2:55678
    tls:
      cert_file: file.cert
      key_file: file.key
  opencensus/2:
    endpoint: opencensus2:55678
    tls:
      insecure: true

​
Advanced Configuration

Several helper files are leveraged to provide additional capabilities automatically:

​
Configuration

​
Example Configuration

opencensus:
opencensus/2:
  endpoint: "1.2.3.4:1234"
  compression: "gzip"
  num_workers: 123
  tls:
    ca_file: /var/lib/mycert.pem
  headers:
    "can you have a . here?": "F0000000-0000-0000-0000-000000000000"
    header1: 234
    another: "somevalue"
  balancer_name: "round_robin"
  keepalive:
    time: 20
    timeout: 30
    permit_without_stream: true
  sending_queue:
    enabled: true
    num_consumers: 2
    queue_size: 10
  retry_on_failure:
    enabled: true
    initial_interval: 10s
    max_interval: 60s
    max_elapsed_time: 10m
Last generated: 2026-04-20