Docker Swarm Collector - Configure

Learn how to configure the OpenTelemetry Collector in Docker Swarm to collect and forward telemetry data to SigNoz. This guide covers setup for traces, metrics, and logs from your containers and services.

Prerequisites

A running Docker Swarm cluster
OpenTelemetry Collector deployed as a Swarm service (see Deploy the Collector)
Access to the Docker Engine socket (/var/run/docker.sock) on nodes where the Collector runs
SigNoz Cloud or Self-hosted SigNoz is available for ingestion

Configure the Collector

Docker Stats Collection

The docker_stats receiver connects directly to the Docker Engine socket to scrape cgroup stats.

What it Collects

CPU usage and utilization
Memory usage, limits, and percentages
Network I/O
Container uptime and restarts

📝 Note

You can also map Docker container labels into metric attributes using container_labels_to_metric_labels. This allows grouping and filtering metrics by service, stack, or task in SigNoz dashboards.

config.yaml

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318
  docker_stats:
    endpoint: unix:///var/run/docker.sock
    api_version: "1.48"
    collection_interval: 60s
    container_labels_to_metric_labels:
        com.docker.stack.namespace:        docker.stack.name
        com.docker.swarm.node.id:          docker.node.id
        com.docker.swarm.service.name:     docker.service.name
        com.docker.swarm.task.name:        docker.task.name
    metrics:
      container.cpu.usage.total:
        enabled: true
      container.cpu.utilization:
        enabled: true
      container.cpu.limit:
        enabled: true
      container.memory.usage.total:
        enabled: true
      container.memory.percent:
        enabled: true
      container.memory.usage.limit:
        enabled: true
      container.uptime:
        enabled: true
      container.restarts:
        enabled: true
      container.network.io.usage.rx_bytes:
        enabled: true
      container.network.io.usage.tx_bytes:
        enabled: true


processors:
  batch:

exporters:
  otlp:
    endpoint: "ingest.<YOUR_REGION>.signoz.cloud:443"
    tls:
      insecure: false
    headers:
      "signoz-ingestion-key": "<YOUR_INGESTION_KEY>"

extensions:
  health_check:
  pprof:
  zpages:

service:
  extensions: [health_check, pprof, zpages]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlp]
    metrics:
      receivers: [otlp, docker_stats]
      processors: [batch]
      exporters: [otlp]
    logs:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlp]

📝 Note

Set your ingestion endpoint according to your SigNoz Cloud region. Refer to the SigNoz Cloud ingestion endpoint guide to find the correct endpoint for your deployment.
Replace <SIGNOZ_INGESTION_KEY> with the one provided by SigNoz.

Next Steps

Once you have configured the collector, you can see your container logs, metrics and application traces by following the below links:

Edit on GitHub

Was this page helpful?

Install

Overview

On this page

Prerequisites

Configure the Collector

Docker Stats Collection

Next Steps