OpenCensus Service 0.1.3

OpenCensus Service with Opencensus, Jaeger and Zipkin trace receivers, a variety of exporters and intelligent sampling

• Agent Docker image: docker pull omnition/opencensus-agent:0.1.3
• Collector Docker image: docker pull omnition/opencensus-collector:0.1.3

New features

• receiver/opencensus: Support for TLS
• exporter/opencensus: Support for headers
• exporter/aws-xray: Added
• exporter/honeycomb: Added

Bug fixes

• exporter/opencensus: Address performance bottlenecks

Other changes

• Published codecov numbers
• Published initial performance numbers
• Updated Collector CLI help in README
• Refactoring in preparation for beta2

Checksums

$ > shasum -a 256 bin/*
3eab549bc1ae28553c82597f1148be6ef993aac58cc5ec1267566c606569cc56  bin/ocagent_darwin
6206fa587dce0881b3c97e650f4e7451f833ca7ce350d5035a414478a9badbac  bin/ocagent_linux
69a20abff481396ae80ee1443a549ca430664f0aa79fa6a5de5c3e92f91afd45  bin/ocagent_windows
d8991c4d735b1cc5eb4057b66e25c6a7cc724fce993850e58f27bf444cf704fb  bin/occollector_darwin
2b31d8df49844c62a0d5f1142f7331d55565b32a065ef43045509c3f29706ae7  bin/occollector_linux
ede10764adbb4b4b7f38bee56c49b07a60dc5d32d95b8d8f53ab4ed60606bb30  bin/occollector_windows

OpenCensus Service 0.1.2

OpenCensus Service with Opencensus, Jaeger and Zipkin trace receivers and a variety of exporters

• Agent Docker image: docker pull omnition/opencensus-agent:0.1.2
• Collector Docker image: docker pull omnition/opencensus-collector:0.1.2

New features

• Collector: Intelligent (tail-based) sampling
• Collector: Batch support to all exporters
• receiver/zipkin: Scribe support
• receiver/prometheus: Support

Bug fixes

• receiver/zipkin: v1 json map LOCAL_COMPONENT to "component" (#352)
• receiver/opencensus: grpc-gateway mux should accept all gRPC content-types (#366)
• cmd/ocagent: crash if OpenCensus receiver is not specified in configuration file (#377)
• cmd/ocagent: Ctrl-C with non-defined OpenCensus receiver causes a spurious crash (#379)

Checksums

$ > shasum -a 256 bin/*
79473825dca17f4a19cd14b747cdd44212a7d9e2c845a3a7bc9e347cebb86061  bin/ocagent_darwin
cf7f0ccce0468d49fe645f4ee7950b382b2ea71c20d3c8a7b9dae2021ba6c81e  bin/ocagent_linux
48da5fa2c95a7d2573fe0781d48ea4a87df2f97a68311ce60974f0d628547503  bin/ocagent_windows
2d00f6258232060d1d8aeaa833ef7379a0fc3fb3104f880938b8b4209c5ec41f  bin/occollector_darwin
0a2cd87f1c0fc2b2e007349ba0960b819cca28d0a4150e3104b698c4c397dec1  bin/occollector_linux
2664fdf8e45eb37e70c6e62c548376f7f51898dbeb0848b7acb962fe1fb61765  bin/occollector_windows

OpenCensus Service v0.1.1

OpenCensus Service with Opencensus, Jaeger and Zipkin trace receivers and a variety of exporters

• Agent Docker image: docker pull omnition/opencensus-agent:0.1.1
• Collector Docker image: docker pull omnition/opencensus-collector:0.1.1

New features

• Collector: Added memory and CPU telemetry to prometheus stats
• Collector: Added opencensus exporter
• Agent/Collector: Added compression to opencensus exporter
• receiver/zipkin: Thrift support added
• exporter/prometheus: added
• exporter/stackdriver: updated to support metrics

Bug fixes

• receiver/zipkin: v2 traceID of 8 bytes generates invalid OC Proto traceID (#321)
• cmd/agent no message showing receiver is up confuses users (#326)
• cmd/collector: nil exception with receiver:zipkin and queued-exporter:jaeger (#332)
• exporter/jaeger: can end with two "span.kind" tags (#329)

OpenCensus Service v0.1.0

🎉 Beta1 Release 🎉

OpenCensus Service with Opencensus, Jaeger and Zipkin trace receivers and a variety of exporters

• Agent Docker image: docker pull omnition/opencensus-agent:0.1.0
• Collector Docker image: docker pull omnition/opencensus-collector:0.1.0
• Grafana dashboard: https://grafana.com/dashboards/9680

Note: This release is specifically around tracing, metrics will come in a future release.

⚠️ BREAKING CHANGES ⚠️

Upon upgrade the following configuration changes must be made (not backwards compatible)

• Collector: renamed processors to queued-exporters
• Collector: renamed thrift-http to jaeger-thrift-http

New features

• Collector supports globals tags -- added to each span received by the collector
• Collector exposes Prometheus metrics on :8888/metrics
• Collector has a health endpoint (e.g. readiness and liveness probe) on :13133/
• Collector enables the opencensus receiver by default
• Jaeger exporter now supports MessageEvent

Bug fixes

• Service now respects the service name in a span instead of defaulting to blank
• Fixed a Zipkin nil pointer panic

Other changes

• Updates to README
• Sample Kubernetes YAML configuration available in example/k8s.yaml

OpenCensus Service v0.0.5

OpenCensus Service with Jaeger and Zipkin trace receivers and a variety of exporters + zPages

Minor Changes:

• Zipkin v1 receiver support

OpenCensus Service v0.0.4

OpenCensus Service with Jaeger and Zipkin trace receivers and a variety of exporters + zPages

Major Changes:

• opencensus exporter added -- this will be the default used by OpenCensus Service
• Queue processor added to OpenCensus Collector -- support for bounded buffer retry, HTTPS destinations, an exporter specific configurations

Minor Changes:

• Jaeger receiver now accepts UDP ports (specifically for OpenCensus Agent)
• Jaeger receiver now supports TChannel (port 14267)
• Zipkin receiver now works with partial LocalEndpoint information
• Zipkin exporter now safely retrieves remoteEndpoint serviceName
• Fix Zipkin logical conflict detection

OpenCensus Service v0.0.3

OpenCensus Service with Jaeger and Zipkin trace receivers and exporters + zPages

Major Changes:

• First version of Collector with receivers for OC proto, Jaeger (HTTP thrift 14268), and Zipkin (v2 only) and exporter to Jaeger (Zipkin next release)

Minor Changes:

• Receiver for Jaeger
• Exporter to Jaeger HTTP thrift 14268 (no UDP or TChannel support today)
• Exporter for Kafka (thanks @yancl!)
• Metric foundation added (awaiting Go support)
• Code refactoring

Collector Example

Configure exporter

$ cat config.yaml
exporters:
  jaeger:
    collector_endpoint: "http://jaeger.default.svc.cluster.local:14268/api/traces"

If running locally in Docker use:

$ cat config.yaml
exporters:
  jaeger:
    collector_endpoint: "http://host.docker.local:14268/api/traces"

Run Collector

$ go run github.com/census-instrumentation/opencensus-service/cmd/occollector \
    --config=./config.yaml --receive-oc-trace

If running locally in Docker use:

$ make docker-collector
$ docker run --rm -it -p 55678:55678 -p 14268:14268 \
    -v $(pwd)/config.yaml:/conf.yaml occollector \
    --receive-oc-trace --config=/conf.yaml

OpenCensus Service v0.0.2

OpenCensus with Zipkin trace receiver and exporter + zPages

Minor Changes:

• Rename interceptors to receivers
• Support for Zipkin remoteEndpoint
• Support for Zipkin protobuf parsing

ocagent-uno: OpenCensus + Zipkin Trace interceptors & zPages

This is the first tagged release of this service.

This release is trace-centric in that all the exporters and interceptors are for tracing

Available interceptors

• OpenCensus interceptor
• Zipkin interceptor

Available exporters

• Datadog exporter
• Jaeger exporter
• Stackdriver exporter
• Zipkin exporter

Configuration file

The service takes a YAML file with flag --config
that describes the configuration of the opt-in interceptors and exporters.

The OpenCensus interceptor is ALWAYS enabled since the point of this service/agent is to allow
any library that uses the OpenCensus-Agent exporter to send traces to the agent and use the
various exporters without having to configure them in code and for the language itself

Skeleton of configuration file

exporters:
    [for each exporter]:
       <configuration_key>: <configuration_value>

interceptors:
    [for each interceptor]:
        address: <the address of the interceptor>

for example

interceptors:
    opencensus:
        address: "127.0.0.1:55678"

    zipkin:
        address: "localhost:9411"

exporters:
    stackdriver:
        project: "census-demos"
        enable_tracing: true
    zipkin:
        service_name: "ocagent" # The default serviceName if not set
        local_endpoint: "localhost:9412/api/v2/spans" # The default endpoint
zpages:
    port: 55679

Running it

For example running it on macOS having enabled Zipkin and Stackdriver exporters

./ocagent_darwin --config config.yaml

Diagnostics

The ocagent process comes with zpages that by default run on port 55679. They are useful for in-process diagnostics i.e. to monitor this process itself.
The endpoints availabe are

Name	Route
Tracez	/debug/tracez
Rpcz	/debug/rpcz

Binaries

$ ./build_binaries.sh binaries
GOOS=darwin go build -ldflags "-X github.com/census-instrumentation/opencensus-service/internal/version.GitHash=9bcf605" -o bin/ocagent_darwin ./cmd/ocagent
GOOS=linux go build -ldflags "-X github.com/census-instrumentation/opencensus-service/internal/version.GitHash=9bcf605" -o bin/ocagent_linux ./cmd/ocagent
GOOS=windows go build -ldflags "-X github.com/census-instrumentation/opencensus-service/internal/version.GitHash=9bcf605" -o bin/ocagent_windows ./cmd/ocagent

Checksums

$ shasum -a 256 bin/*
c2bc9542f9fac5e3aa0b47c2b0976477208148a485c4e1fbb603a5cddcd26f2c  bin/ocagent_darwin
4743d31996ec259ce600a7dc2cf61582a0cdce5e6e1cf38e83cdac68b10b783f  bin/ocagent_linux
873a126401e5e6b558fb143f7072d01cec45f389e97f007d674c7cbb696fa75c  bin/ocagent_windows

Cheers to more updates, collaboration and delivering value!