Host

Para configurar este check para un Agent que se ejecuta en un host:

1. Edita el archivo solr.d/conf.yaml en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent. Para conocer todas las opciones de configuración disponibles, consulta el solr.d/conf.yaml de ejemplo.

   init_config:
   
     ## @param is_jmx - boolean - required
     ## Whether or not this file is a configuration for a JMX integration.
     #
     is_jmx: true
   
     ## @param collect_default_metrics - boolean - required
     ## Whether or not the check should collect all default metrics.
     #
     collect_default_metrics: true
   
   instances:
     ## @param host - string - required
     ## Solr host to connect to.
     - host: localhost
   
       ## @param port - integer - required
       ## Solr port to connect to.
       port: 9999
   

2. Reinicia el Agent.

Lista de métricas

El parámetro conf es una lista de métricas que recopilará la integración. Solo se admiten 2 claves:

• include (obligatorio): un diccionario de filtros, cualquier atributo que coincida con estos filtros se recopila a menos que también coincida con los filtros exclude (ver más abajo).
• exclude (opcional): un diccionario de filtros, los atributos que coinciden con estos filtros no se recopilan.

Para un bean dado, las métricas se etiquetan de la siguiente manera:

mydomain:attr0=val0,attr1=val1

En este ejemplo, tu métrica es mydomain (o alguna variación según el atributo dentro del bean) y tiene las etiquetas attr0:val0, attr1:val1 y domain:mydomain.

Si especificas un alias en una clave include con formato camel case, se convierte a snake case. Por ejemplo, MyMetricName aparece en Datadog como my_metric_name.

El filtro de atributos

El filtro attribute puede aceptar dos tipos de valores:

• Un diccionario cuyas claves son nombres de atributos (ver más adelante). Para este caso, puedes especificar un alias para la métrica que se convierte en el nombre de métrica en Datadog. También puedes especificar el tipo de métrica como gauge o count. Si eliges count, se calcula una tasa por segundo para la métrica.

  conf:
    - include:
      attribute:
        maxThreads:
          alias: tomcat.threads.max
          metric_type: gauge
        currentThreadCount:
          alias: tomcat.threads.count
          metric_type: gauge
        bytesReceived:
          alias: tomcat.bytes_rcvd
          metric_type: counter
  

• Una lista de nombres de atributos (ver más abajo). Para este caso, el tipo de métrica es un gauge y el nombre de métrica es jmx.\[DOMAIN_NAME].\[ATTRIBUTE_NAME].

  conf:
    - include:
      domain: org.apache.cassandra.db
      attribute:
        - BloomFilterDiskSpaceUsed
        - BloomFilterFalsePositives
        - BloomFilterFalseRatio
        - Capacity
        - CompressionRatio
        - CompletedTasks
        - ExceptionCount
        - Hits
        - RecentHitRate
  

Versiones anteriores

La lista de filtros solo se admite en el Datadog Agent > 5.3.0. Si utilizas una versión anterior, utiliza singletons y varias sentencias include en su lugar.

# Datadog Agent > 5.3.0
  conf:
    - include:
      domain: domain_name
      bean:
        - first_bean_name
        - second_bean_name
# Older Datadog Agent versions
  conf:
    - include:
      domain: domain_name
      bean: first_bean_name
    - include:
      domain: domain_name
      bean: second_bean_name

Contenedores

Para obtener información sobre entornos en contenedores, consulta la guía Autodiscovery con JMX.

Recopilación de logs

1. La recopilación de logs está desactivada por defecto en el Datadog Agent, actívala en tu archivo datadog.yaml:

    logs_enabled: true
   

2. Solr utiliza el registrador log4j por defecto. Para personalizar el formato de registro, edita el archivo server/resources/log4j2.xml. Por defecto, el pipeline de la integración de Datadog admite el siguiente patrón de conversión:

   %maxLen{%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p (%t) [%X{collection} %X{shard} %X{replica} %X{core}] %c{1.} %m%notEmpty{ =>%ex{short}}}{10240}%n
   

   Clona y edita el pipeline de integración si tienes un formato diferente.

3. Anula los comentarios y edita el bloque de configuración de logs en tu archivo solr.d/conf.yaml. Cambia los valores de los parámetros type, path y service en función de tu entorno. Consulta solr.d/solr.yaml de ejemplo para conocer todas las opciones disponibles de configuración.

    logs:
      - type: file
        path: /var/solr/logs/solr.log
        source: solr
        # To handle multi line that starts with yyyy-mm-dd use the following pattern
        # log_processing_rules:
        #   - type: multi_line
        #     pattern: \d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])
        #     name: new_log_start_with_date
   

4. Reinicia el Agent.

Para habilitar logs para entornos de Kubernetes, consulta Recopilación de log de Kubernetes.