Supported OS Linux Windows Mac OS

Versión de la integración4.1.0

Información general

Squid es un servidor de almacenamiento en caché y reenvío de proxy web de código abierto que funciona como intermediario entre clientes y servidores en red. Actúa como puerta de enlace, permitiendo a los clientes acceder a diversos recursos de Internet, como sitios web, archivos y otros contenidos de los servidores.

Esta integración proporciona enriquecimiento y visualización para logs de Squid. Lo ayuda a visualizar información detallada del análisis de logs de Squid a través de las reglas de detección y dashboards predefinidos, mejorando las capacidades de detección y respuesta.

Además, incluye monitores preconfigurados para enviar notificaciones proactivas sobre lo siguiente:

  1. Tasa alta de errores del servidor
  2. Uso de CPU excedido
  3. Solicitudes de alta latencia
  4. Tasa alta de errores HTTP del cliente

Este check monitoriza métricas de Squidi del Gestor de caché a través del Datadog Agent.

Configuración

Instalación

El check de Squid del Agent está incluido en el paquete del Datadog Agent. No es necesaria ninguna instalación adicional en tu servidor Squid.

Configuración

Host

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

Recopilación de métricas
  1. Edita el archivo squid.d/conf.yaml, que se encuentra 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 squid.d/conf.yaml de ejemplo:

  2. Reinicia el Agent.

Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

  1. La recopilación de logs está deshabilitada por defecto en el Datadog Agent; habilítala en tu archivo datadog.yaml:

    logs_enabled: true
    
  2. Descomenta y edita este bloque de configuración en la parte inferior de tu archivo squid.d/conf.yaml:

    logs:
      - type: file
        path: /var/log/squid/cache.log
        service: "<SERVICE-NAME>"
        source: squid
      - type: file
        path: /var/log/squid/access.log
        service: "<SERVICE-NAME>"
        source: squid
    

    Cambia los valores de los parámetros path y service y configúralos para tu entorno.

  3. Reinicia el Agent.

Contenedores

Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.

Recopilación de métricas
ParámetroValor
<INTEGRATION_NAME>squid
<INIT_CONFIG>en blanco o {}
<INSTANCE_CONFIG>{"name": "<SQUID_INSTANCE_NAME>", "host": "%%host%%", "port":"3128"}
Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta Recopilación de logs de Kubernetes.

ParámetroValor
<LOG_CONFIG>{"source": "squid", "service": "<YOUR_APP_NAME>"}

Validación

Ejecuta el subcomando de estado del Agent y busca squid en la sección Checks.

Datos recopilados

Logs

La integración de Squid recopila los logs de acceso y caché.

Formatos de logs de acceso compatibles

NombreEspecificación de formato
squid%ts.%03tu %6tr %>a %Ss/%03>Hs %<st %rm %ru %[un %Sh/%<a %mt
común%>a - %[un [%tl] "%rm %ru HTTP/%rv" %>Hs %<st %Ss:%Sh
combinado%>a - %[un [%tl] "%rm %ru HTTP/%rv" %>Hs %<st "%{Referer}>h" "%{User-Agent}>h" %Ss:%Sh

Para más información, consulta Formatos de logs de Squid.

Nota: El tipo logformat por defecto es squid. Puedes actualizar el formato de log compatible en /etc/squid/squid.conf, luego reinicia Squid.

Para utilizar el tipo combined para logformat, añade las siguientes líneas a tu archivo /etc/squid/squid.conf:

logformat combined   %>a %[ui %[un [%tl] "%rm %ru HTTP/%rv" %>Hs %<st "%{Referer}>h" "%{User-Agent}>h" %Ss:%Sh
access_log /var/log/squid/access.log combined

A continuación, reinicia el servicio squid mediante el siguiente comando:

sudo systemctl restart squid

Nota:

  • El panel Top Avg Request Duration by URL Host se cargará sólo si el tipo squid por defecto de logformat está configurado.
  • Los paneles Top Browsers y Top HTTP Referrer sólo se cargarán si el tipo combined de logformat está configurado.

Métricas

Eventos

El check de Squid no incluye eventos.

Checks de servicio

Resolución de problemas

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

PREVIEWING: may/embedded-workflows