summaryrefslogtreecommitdiffstats
path: root/doc/cephadm/services/tracing.rst
blob: e96d601d26d7c945eb2d8a4c499fa5b582df0024 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
================
Tracing Services
================

.. _cephadm-tracing:


Jaeger Tracing
==============

Ceph uses Jaeger as the tracing backend. in order to use tracing, we need to deploy those services.

Further details on tracing in ceph:

`Ceph Tracing documentation <https://docs.ceph.com/en/latest/jaegertracing/#jaeger-distributed-tracing/>`_

Deployment
==========

Jaeger services consist of 3 services:

1. Jaeger Agent

2. Jaeger Collector

3. Jaeger Query

Jaeger requires a database for the traces. we use ElasticSearch (version 6) by default.


To deploy jaeger tracing service, when not using your own ElasticSearch:

#. Deploy jaeger services, with a new elasticsearch container:

    .. prompt:: bash #

        ceph orch apply jaeger


#. Deploy jaeger services, with existing elasticsearch cluster and existing jaeger query (deploy agents and collectors):

     .. prompt:: bash #

        ceph orch apply jaeger --without-query --es_nodes=ip:port,..