OpenCensus Receiver

Status
Stability	beta: metrics, traces
Distributions	core, contrib
Issues
Code Owners	@open-telemetry/collector-approvers

Receives data via gRPC or HTTP using OpenCensus format.

Getting Started

All that is required to enable the OpenCensus receiver is to include it in the receiver definitions.

receivers:
  opencensus:

The following settings are configurable:

• endpoint (default = localhost:55678): host:port to which the receiver is going to receive data. The valid syntax is described at https://github.com/grpc/grpc/blob/master/doc/naming.md. You can temporarily disable the component.UseLocalHostAsDefaultHost feature gate to change this to 0.0.0.0:55678. This feature gate will be removed in a future release.

Advanced Configuration

Several helper files are leveraged to provide additional capabilities automatically:

• gRPC settings including CORS
• TLS and mTLS settings
• Queuing, retry and timeout settings

Writing with HTTP/JSON

The OpenCensus receiver can receive trace export calls via HTTP/JSON in addition to gRPC. The HTTP/JSON address is the same as gRPC as the protocol is recognized and processed accordingly.

To write traces with HTTP/JSON, POST to [address]/v1/trace. The JSON message format parallels the gRPC protobuf format, see this OpenApi spec for it.

The HTTP/JSON endpoint can also optionally configure CORS, which is enabled by specifying a list of allowed CORS origins in the cors_allowed_origins field:

receivers:
  opencensus:
    cors_allowed_origins:
    - http://test.com
    # Origins can have wildcards with *, use * by itself to match any origin.
    - https://*.example.com