Información general

Esta integración monitoriza Sidekiq a través de DogStatsD. Recopila métricas a través de el cliente DogStatsD Ruby de Datadog.

Nota Solo los usuarios de Sidekiq Pro (>= 3.6) o Enterprise (>= 1.1.0) pueden recopilar métricas.

Configuración

Instalación

La integración de Sidekiq viene en el paquete del Datadog Agent. No es necesaria ninguna instalación adicional en tu servidor.

Configuración

1. Instala el gem dogstatsd-ruby:

    gem install dogstatsd-ruby
   

2. Habilita la recopilación de métricas de Sidekiq Pro incluyendo esto en tu inicializador; para un despliegue en contenedores, actualiza localhost a tu dirección del contenedor del Agent:

        require 'datadog/statsd' # gem 'dogstatsd-ruby'
   
        Sidekiq::Pro.dogstatsd = ->{ Datadog::Statsd.new('localhost', 8125, namespace:'sidekiq') }
   
        Sidekiq.configure_server do |config|
          config.server_middleware do |chain|
            require 'sidekiq/middleware/server/statsd'
            chain.add Sidekiq::Middleware::Server::Statsd
          end
        end
   

   Si utilizas Sidekiq Enterprise y deseas recopilar métricas históricas, incluye también esta línea:

          Sidekiq.configure_server do |config|
            # history is captured every 30 seconds by default
            config.retain_history(30)
          end
   

   Consulta la documentación de Sidekiq Pro y Enterprise para obtener más información y la documentación de DogStatsD Ruby para obtener más opciones de configuración.

3. Actualiza el archivo de configuración principal del Datadog Agent datadog.yaml añadiendo las siguientes configuraciones:

   # dogstatsd_mapper_cache_size: 1000  # default to 1000
   dogstatsd_mapper_profiles:
     - name: sidekiq
       prefix: "sidekiq."
       mappings:
         - match: 'sidekiq\.sidekiq\.(.*)'
           match_type: "regex"
           name: "sidekiq.$1"
         - match: 'sidekiq\.jobs\.(.*)\.perform'
           name: "sidekiq.jobs.perform"
           match_type: "regex"
           tags:
             worker: "$1"
         - match: 'sidekiq\.jobs\.(.*)\.(count|success|failure)'
           name: "sidekiq.jobs.worker.$2"
           match_type: "regex"
           tags:
             worker: "$1"
   

   Estos parámetros también pueden establecerse añadiendo la variable de entorno DD_DOGSTATSD_MAPPER_PROFILES al Datadog Agent.

4. Reinicia el Agent.

Datos recopilados

Métricas

The Sidekiq integration also allows custom metrics, see Sidekiq Enterprise Historical Metrics.

La integración de Sidekiq también permite métricas personalizadas, consulta Métricas históricas de Sidekiq Enterprise.

Recopilación de logs

1. La recopilación de logs está desactivada por defecto en el Datadog Agent. Habilítalo en el archivo datadog.yaml con:

     logs_enabled: true
   

2. Añade este bloque de configuración a tu archivo sidekiq.d/conf.yaml para empezar a recopilar tus logs de Sidekiq:

     logs:
       - type: file
         path:  /var/log/sidekiq.log
         source: sidekiq
         service: <SERVICE>
   

   Cambia los valores de los parámetros path y service y configúralos para tu entorno. Si no encuentras tus logs, consulta registro de Sidekiq.

3. Reinicia el Agent.

Checks de servicio

Sidekiq no incluye ningún check de servicio.

Eventos

Sidekiq no incluye ningún evento.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.