Setup Data Streams Monitoring for Ruby
이 페이지는 아직 한국어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우
언제든지 연락주시기 바랍니다.Prerequisites
Supported libraries
| Technology | Library | Minimum library version | Minimal tracer version | Recommended tracer version |
|---|
| Kafka | ruby-kafka | 0.7.10 | 2.23.0 | 2.23.0 or later |
| Kafka | karafka | 2.3.0 | 2.23.0 | 2.23.0 or later |
| Kafka | waterdrop | 2.8.8 | 2.23.0 | 2.23.0 or later |
Installation
Ruby uses auto-instrumentation to inject and extract additional metadata required by Data Streams Monitoring for measuring end-to-end latencies and the relationship between queues and services. To enable Data Streams Monitoring, set the DD_DATA_STREAMS_ENABLED environment variable to true on services sending messages to (or consuming messages from) Kafka.
For example:
environment:
- DD_DATA_STREAMS_ENABLED: "true"
- DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED: "true"
Monitoring Kafka Pipelines
Data Streams Monitoring uses message headers to propagate context through Kafka streams. If log.message.format.version is set in the Kafka broker configuration, it must be set to 0.11.0.0 or higher. Data Streams Monitoring is not supported for versions lower than this.
Manual instrumentation
Data Streams Monitoring propagates context through message headers. If you are using a message queue technology that is not supported by DSM, a technology without headers (such as Kinesis), use manual instrumentation to set up DSM.
Further reading
