Uso básico del Agent para macOS
En esta página se describen las funciones básicas del Datadog Agent para macOS. Si aún no has instalado el Agent, consulta las instrucciones en la documentación sobre la integración del Datadog Agent.
Por defecto, el Agent se instala en un entorno de pruebas ubicado en /opt/datadog-agent. Puedes mover esta carpeta a cualquier otro lugar; sin embargo, esta documentación asume una localización de instalación por defecto.
Versiones de macOS compatibles
| versión de macOS | Versiones del Agent compatibles |
|---|
| macOS 10.10 y 10.11 | Agent v5 |
| macOS 10.12 | Agent v5, Agent v6 hasta la versión 6.34.0, Agent v7 hasta la versión 7.34.0 |
| macOS 10.13 | Agent v5, Agent v6 hasta la versión 6.38.2, Agent v7 hasta la versión 7.38.2 |
| macOS 10.14 y posteriores | Agent v5, Agent v6, Agent v7 |
Comandos
En las versiones 6 y 7 del Agent, el gestor de servicios launchctl proporcionado por el sistema operativo es responsable del ciclo de vida del Agent, mientras que para ejecutar otros comandos hay que hacerlo directamente a través del sistema binario del Agent. Otra posibilidad es gestionar los comandos del ciclo de vida a través de la aplicación systray, y ejecutar otros comandos con la GUI web.
| Descripción | Comando |
|---|
| Ejecutar el Agent como un servicio | launchctl start com.datadoghq.agent o a través de la aplicación systray |
| Detener la ejecución del Agent como servicio | launchctl stop com.datadoghq.agent o a través de la aplicación systray |
| Reiniciar la ejecución del Agent como servicio | ejecutar stop y luego start o a través de la aplicación systray |
| Estado del servicio Agent | launchctl list com.datadoghq.agent o a través de la aplicación systray |
| Página de estado del Agent en ejecución | datadog-agent status o con la GUI web |
| Enviar un flare | datadog-agent flare o con la GUI web |
| Mostrar el uso de comandos | datadog-agent --help |
| Ejecutar un check | datadog-agent check <CHECK_NAME> |
| Descripción | Comando |
|---|
| Ejecutar el Agent como un servicio | datadog-agent start |
| Detener la ejecución del Agent como servicio | datadog-agent stop |
| Reiniciar la ejecución del Agent como servicio | datadog-agent restart |
| Estado del servicio Agent | datadog-agent status |
| Página de estado del Agent en ejecución | datadog-agent info |
| Enviar un flare | datadog-agent flare |
| Mostrar el uso de comandos | no aplica |
| Ejecutar un check | datadog-agent check <CHECK_NAME> |
Configuración
Los archivos y carpetas de configuración del Agent se encuentran en:
~/.datadog-agent/datadog.yaml
Archivos de configuración para las integraciones:
Los archivos y carpetas de configuración del Agent se encuentran en:
~/.datadog-agent/datadog.conf
Archivos de configuración para las integraciones:
Desinstalar el Agent
Instalación por un solo usuario
Para eliminar el Agent y todos sus archivos de configuración:
- Detén y cierra el Datadog Agent con el icono en forma de hueso en la bandeja.
- Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.
- Ejecuta los siguientes comandos:
sudo rm -rf /opt/datadog-agent
sudo rm -rf /usr/local/bin/datadog-agent
sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
launchctl remove com.datadoghq.agent
sudo rm -rf /var/log/datadog
- Reinicia el equipo para que se apliquen los cambios.
Instalación de LaunchDaemon en todo el sistema
Para eliminar el Agent y todos sus archivos de configuración:
- Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.
- Para eliminar los archivos que queden, ejecuta lo siguiente:
sudo rm -rf /opt/datadog-agent
sudo rm -rf /usr/local/bin/datadog-agent
sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
sudo launchctl disable system/com.datadoghq.agent && sudo launchctl bootout system/com.datadoghq.agent
sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm -rf /var/log/datadog
- Reinicia el equipo para que se apliquen los cambios.
- Detén y cierra el Datadog Agent con el icono en forma de hueso en la bandeja.
- Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.
- Ejecuta lo siguiente:
sudo rm -rf /opt/datadog-agent
sudo rm -rf /usr/local/bin/datadog-agent
sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
Si has ejecutado los comandos de instalación opcionales para que el Agent se ejecute en el arranque, ejecuta lo siguiente para finalizar la desinstalación:
sudo launchctl unload -w /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist
Este método elimina el Agent, así como todos sus archivos de configuración.
Solucionar problemas
Consulta la documentación sobre cómo solucionar problemas del Agent.
Trabajar con el Agent integrado
El Agent tiene un entorno de Python integrado en /opt/datadog-agent/embedded/. Los archivos binarios comunes, como python y pip, se encuentran dentro de /opt/datadog-agent/embedded/bin/.
Si quieres obtener más información, consulta las instrucciones sobre cómo añadir paquetes al Agent integrado.
Lectura adicional
Más enlaces, artículos y documentación útiles:
