Cómo trabajar con el agente Linux

Después de suministrar una instancia del servicio IBM Cloud Monitoring en IBM Cloud, puede desplegar el agente Monitoring en los hosts Linux para recopilar datos y métricas automáticamente. Puede configurar las métricas que se deben supervisar en cada entorno.

Puede asociar una o varias etiquetas a cada agente de supervisión. Las etiquetas son valores separados por comas con el formato NOMBRE_ETIQUETA:VALOR_ETIQUETA. Cuando supervise el entorno, puede utilizar estas etiquetas para identificar las métricas que están disponibles en un agente. Por ejemplo, puede incluir información sobre el nombre y la ubicación del servicio con todas las métricas recopiladas por este agente.

Requisitos previos

Compruebe el tema Ajustar agente

Despliegue del agente de Linux utilizando un script

Siga los pasos siguientes para configurar un agente de supervisión en Linux para que recopile y reenvíe métricas a una instancia del servicio IBM Cloud Monitoring:

Obtenga la clave de acceso.
Obtenga el URL de ingestión público o privado. Para obtener más información, consulte Puntos finales de recopilador.
Instale las cabeceras del kernel.

Cuando instala un agente de supervisión, el agente utiliza archivos de cabecera de kernel. Más información

Elija una distribución y ejecute el siguiente mandato para esa distribución.

Para las distribuciones de Linux Debian y Ubuntu, ejecute el mandato siguiente:
```
apt-get -y install linux-headers-$(uname -r)
```
Para las distribuciones de Linux RHEL, CentOS y Fedora, ejecute el siguiente mandato:
```
yum -y install kernel-devel-$(uname -r)
```
Despliegue el agente de supervisión. Ejecute el mandato siguiente desde un terminal.
```
curl -sL https://ibm.biz/install-sysdig-agent | sudo bash -s -- --access_key MONITORING_ACCESS_KEY --collector COLLECTOR_ENDPOINT --collector_port 6443  --tags TAG_DATA --additional_conf 'sysdig_capture_enabled: false\nfeature:\n    mode: monitor_light'
```
Donde
- MONITORING_ACCESS_KEY es la clave de ingestión para la instancia.
- COLLECTOR_ENDPOINT es el URL de ingestión público o privado para la región donde la instancia de supervisión está disponible. Para obtener un punto final, consulte Puntos finales de Collector.
- TAG_DATA son etiquetas separadas por comas con el formato NOMBRE_ETIQUETA_VALOR:ETIQUETA. Puede asociar una o varias etiquetas al agente de supervisión. Por ejemplo, role:serviceX,location:us-south.
- Establezca sysdig_capture_enabled en false para inhabilitar la característica de captura. De forma predeterminada, está establecido en true. Para obtener más información, consulte Cómo trabajar con capturas.
Para instalar cURL, ejecute yum -q -y install curl para las distribuciones RHEL, CentOS y Fedora Linux.
Compruebe que el agente de supervisión se está ejecutando. Ejecute el siguiente mandato:
```
ps -ef | grep sysdig
```
Para ver los últimos registros del agente de supervisión, vaya al directorio /opt/draios/logs y consulte el archivo de registro draios.log.

Para buscar errores, puede ejecutar el siguiente mandato:
```
grep error /opt/draios/logs/draios.log
```

Comprobación del estado de un agente mediante la CLI

Para comprobar el estado de un agente, ejecute el siguiente mandato:

service dragent status

Comprobación de la versión de un agente mediante la CLI

Para comprobar la versión de un agente, ejecute el siguiente mandato:

/opt/draios/bin/dragent --version

Actualización de un agente de Linux

Realice los pasos siguientes para actualizar un agente de supervisión en Linux:

Para actualizar el agente desde distribuciones Debian y Ubuntu Linux, ejecute los mandatos siguientes como usuario sudo desde un terminal:
```
sudo apt-get update
```
```
sudo apt-get -y install draios-agent
```
Para actualizar el agente desde distribuciones RHEL, CentOS y Fedora Linux, ejecute los mandatos siguientes como usuario sudo desde un terminal:
```
yum clean expire-cache
```
```
sudo yum -y install draios-agent
```

Eliminación de un agente de supervisión desplegado como un servicio en un sistema Linux

Realice los pasos siguientes para eliminar un agente de supervisión en Linux:

Para desinstalar el agente de las distribuciones de Linux Debian y Ubuntu, ejecute el mandato siguiente como usuario sudo desde un terminal:
```
sudo apt-get remove draios-agent
```
Para desinstalar el agente de las distribuciones de Linux RHEL, CentOS y Fedora, ejecute el mandato siguiente como usuario sudo desde un terminal:
```
sudo yum erase draios-agent
```

Visualización de los registros de un agente

Para ver los últimos registros del agente de supervisión, vaya al directorio /opt/draios/logs y consulte el archivo de registro draios.log.

Para buscar errores, puede ejecutar el siguiente mandato:

grep error /opt/draios/logs/draios.log

Verificación del estado del agente

Compruebe que el agente de supervisión se está ejecutando. Ejecute el siguiente mandato:

ps -ef | grep sysdig