OpenCensus
Introduction
The OpenCensus receiver allows the OpenCensus Service to capture traces and metrics from applications that implement the OpenCensus Protocol
Accepted formats
By default, the OpenCensus Service listens on TCP port 55678
and receives traffic from:
- HTTP/2 clients with Protobuf messages
- HTTP/1 clients that use the grpc-gateway
Configuration
An OpenCensus receiver can be turned on by using the configuration file sub-section “opencensus” under “receivers”
Format
receivers:
opencensus:
address: <host:port>
Example
receivers:
opencensus:
address: "localhost:55678"
and when OpenCensus Service is re-run, it should produce such output
Agent
2019/02/12 18:57:25 Running OpenCensus Trace and Metrics receivers as a gRPC service at "localhost:55678"
2019/02/12 18:57:25 Running zPages at ":55679"
Collector
{"level":"info","ts":1551744415.5136526,"caller":"opencensus/receiver.go:62","msg":"OpenCensus receiver is running.","port":55678}
Application level exporters
To use OpenCensus in your applications and directly export the collected traces, stats and metrics to the OpenCensus Service, please look at these respective language guides:
Language | Reference |
---|---|
Go | opencensus-go-exporter |
Python | opencensus-python-exporter |
Java | opencensus-java-trace-exporter and opencensus-java-metrics-exporter |
Node.js | opencensus-node-exporter |
References
Resource | URL |
---|---|
OpenCensus Protocol | opencensus protocol |
grpc-gateway | https://github.com/grpc-ecosystem/grpc-gateway |
Go exporter | opencensus-go-exporter |
Python exporter | opencensus-python-exporter |
Java exporter | opencensus-java-trace-exporter and opencensus-java-metrics-exporter |
Node exporter | opencensus-node-exporter |