AGENTS.md

1# Telemetry
2 
3This directory contains the implementation of gRPC's telemetry system.
4 
5## Overarching Purpose
6 
7The telemetry system provides a way to collect and report metrics and tracing about the behavior of gRPC. This information can be used for monitoring, debugging, and performance tuning.
8 
9## Files
10 
11- **`call_tracer.h` / `call_tracer.cc`**: Defines the `CallTracer` class, which is used to trace the lifecycle of a gRPC call.
12- **`metrics.h` / `metrics.cc`**: Defines the `Metrics` class, which is used to collect and report metrics.
13- **`stats.h` / `stats.cc`**: Defines the `Stats` class, which is used to collect and report statistics.
14- **`tcp_tracer.h` / `tcp_tracer.cc`**: Defines the `TcpTracer` class, which is used to trace TCP-level events.
15 
16## Notes
17 
18- The telemetry system is a key component of gRPC's observability infrastructure.
19- It provides a wealth of information about the behavior of gRPC, which can be used to diagnose and fix a wide variety of problems.
20- The telemetry data can be exported to a variety of monitoring systems, such as Prometheus and OpenCensus.
21