:title: Tracing

.. _tracing:

Tracing
#######

The Jaeger tracing server is installed on tracing.opendev.org.  It is
intended to be used by Zuul, but may be used by other services in the
future.  It displays information about Zuul operations in visual form.

At a Glance
===========

:Hosts:
  * https://tracing.opendev.org
:Ansible:
  * https://opendev.org/opendev/system-config
  * :git_file:`playbooks/roles/jaeger`
  * :git_file:`playbooks/service-tracing.yaml`
:Projects:
  * https://www.jaegertracing.io/
  * https://www.jaegertracing.io/docs/latest/getting-started/
:Bugs:
  * https://storyboard.openstack.org/#!/project/748

Overview
========

Apache is configured as a reverse proxy and there is an internal
Badger database stored at ``/var/jaeger/badger``.

Zuul sends telemetry information to Jaeger via the gRPC protocol.

The internal CA (`zk-ca`) used to create ZooKeeper certs for Zuul is
used to provide and validate client certificates for the gRPC
connection to Jaeger as well.