Versión de la integración4.1.0
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:
- Tasa alta de errores del servidor
- Uso de CPU excedido
- Solicitudes de alta latencia
- 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
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:
Reinicia el Agent.
Recopilación de logs
Disponible para la versión 6.0 o posteriores del Agent
La recopilación de logs está deshabilitada por defecto en el Datadog Agent; habilítala en tu archivo datadog.yaml
:
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.
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ámetro | Valor |
---|
<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ámetro | Valor |
---|
<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é.
Nombre | Especificació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.