ContextQMD
Back to Victoriametrics

README

docs/opentelemetry/README.md

1.142.07.0 KB
Original Source

VictoriaMetrics software provides native OpenTelemetry ingestion across metrics, logs, and traces via dedicated components. This allows running OpenTelemetry-based observability pipeline with VictoriaMetrics software as your backend.

VictoriaMetrics provides a dedicated database for each signal type:

{width="700"}

Each database is optimized for its own signal and usage scenario to improve maintainability and efficiency.

Resources:

Metrics (VictoriaMetrics)

VictoriaMetrics single-node, vmagent and vminsert components support ingestion of metrics via OpenTelemetry Protocol (OTLP) from OpenTelemetry Collector and applications instrumented with OpenTelemetry SDKs.

See the detailed description about protocol support here.

See a practical guide How to use OpenTelemetry metrics with VictoriaMetrics.

Once metrics are ingested into VictoriaMetrics, they can be read via the following tools:

  1. vmui - VictoriaMetrics User Interface for ad-hoc queries and data exploration.
  2. Grafana - integrates with VictoriaMetrics using Prometheus datasource or VictoriaMetrics datasource plugins.
  3. Perses - integrates with VictoriaMetrics via Prometheus plugins.
  4. vmalert - is an alerting tool for VictoriaMetrics. It executes a list of the given alerting or recording rules and sends notifications to Alertmanager.

Logs (VictoriaLogs)

VictoriaLogs single-node, vlagent and vlinsert components support ingestion of logs via OpenTelemetry Protocol (OTLP) from OpenTelemetry Collector and applications instrumented with OpenTelemetry SDKs.

See the detailed description about protocol support here.

See a practical guide How to use OpenTelemetry metrics with VictoriaLogs.

Once logs are ingested into Victorialogs, they can be read via the following tools:

  1. vmui - VictoriaLogs User Interface for ad-hoc queries and data exploration.
  2. Grafana - integrates with VictoriaLogs using VictoriaLogs datasource plugin.
  3. Perses - integrates with VictoriaLogs via VictoriaLogs plugins.
  4. vmalert - is an alerting tool for VictoriaLogs. It executes a list of the given alerting and sends notifications to Alertmanager. It can convert LogsQL queries into metrics via recording rules and persist them into VictoriaMetrics.

Traces (VictoriaTraces)

VictoriaTraces single-node and vtinsert components support ingestion of traces via OpenTelemetry Protocol (OTLP) from OpenTelemetry Collector and applications instrumented with OpenTelemetry SDKs.

See the detailed description about protocol support here.

Once traces are ingested into VictoriaTraces, they can be read via the following tools:

  1. Grafana - integrates with VictoriaTraces using Jaeger datasource plugin.
  2. Jaeger frontend - integrates with VictoriaTraces via Jaeger Query Service JSON APIs.
  3. vmalert - is an alerting tool for VictoriaTraces. It executes a list of the given alerting and sends notifications to Alertmanager. It can convert LogsQL queries into metrics via recording rules and persist them into VictoriaMetrics.

Correlations

Signals can be correlated together if they share the same list of attributes, so they can uniquely identify the same system or event. The recommended user interface for correlations is Grafana thanks to its correlation interfaces. See below various scenarios of correlating signals in Grafana using VictoriaMetrics, VictoriaLogs and VictoriaTraces as backends.

Depending on the Grafana datasource plugin there could be multiple correlations available:

  1. Trace to logs, log to trace, log to metrics - see correlations via VictoriaLogs plugin.
  2. Trace to metrics, metric to logs, metric to traces - see correlations via VictoriaMetrics plugin.
  3. Metrics to logs or traces correlations are possible via Prometheus datasource as well.
  4. Plugins Tempo, Jaeger, and Zipkin can correlate with logs or metrics using Trace to logs and Trace to metrics feature.