File: README.rst

package info (click to toggle)
python-opentelemetry 1.39.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,952 kB
  • sloc: python: 53,083; sh: 398; makefile: 142; sql: 39
file content (63 lines) | stat: -rw-r--r-- 2,219 bytes parent folder | download
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
Prometheus Instrumentation
==========================

This shows how to use ``opentelemetry-exporter-prometheus`` to automatically generate Prometheus metrics.

The source files of these examples are available :scm_web:`here <docs/examples/metrics/prometheus-grafana/>`.

Preparation
-----------

This example will be executed in a separate virtual environment:

.. code-block::

    $ mkdir prometheus_auto_instrumentation
    $ virtualenv prometheus_auto_instrumentation
    $ source prometheus_auto_instrumentation/bin/activate


Installation
------------

.. code-block::

    $ pip install -r requirements.txt


Execution
---------

.. code-block::

    $ python ./prometheus-monitor.py
    $ Server is running at http://localhost:8000

Now you can visit http://localhost:8000/metrics to see Prometheus metrics. 
You should see something like:

.. code-block::

    # HELP python_gc_objects_collected_total Objects collected during gc
    # TYPE python_gc_objects_collected_total counter
    python_gc_objects_collected_total{generation="0"} 320.0
    python_gc_objects_collected_total{generation="1"} 58.0
    python_gc_objects_collected_total{generation="2"} 0.0
    # HELP python_gc_objects_uncollectable_total Uncollectable objects found during GC
    # TYPE python_gc_objects_uncollectable_total counter
    python_gc_objects_uncollectable_total{generation="0"} 0.0
    python_gc_objects_uncollectable_total{generation="1"} 0.0
    python_gc_objects_uncollectable_total{generation="2"} 0.0
    # HELP python_gc_collections_total Number of times this generation was collected
    # TYPE python_gc_collections_total counter
    python_gc_collections_total{generation="0"} 61.0
    python_gc_collections_total{generation="1"} 5.0
    python_gc_collections_total{generation="2"} 0.0
    # HELP python_info Python platform information
    # TYPE python_info gauge
    python_info{implementation="CPython",major="3",minor="8",patchlevel="5",version="3.8.5"} 1.0
    # HELP MyAppPrefix_my_counter_total 
    # TYPE MyAppPrefix_my_counter_total counter
    MyAppPrefix_my_counter_total 964.0
 
``MyAppPrefix_my_counter_total`` is the custom counter created in the application with the custom prefix ``MyAppPrefix``.