Uso básico del Agent para macOS

Información general

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 macOSVersiones del Agent compatibles
macOS 10.10 y 10.11Agent v5
macOS 10.12Agent v5, Agent v6 hasta la versión 6.34.0, Agent v7 hasta la versión 7.34.0
macOS 10.13Agent v5, Agent v6 hasta la versión 6.38.2, Agent v7 hasta la versión 7.38.2
macOS 10.14 y posterioresAgent 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ónComando
Ejecutar el Agent como un serviciolaunchctl start com.datadoghq.agent o a través de la aplicación systray
Detener la ejecución del Agent como serviciolaunchctl stop com.datadoghq.agent o a través de la aplicación systray
Reiniciar la ejecución del Agent como servicioejecutar stop y luego start o a través de la aplicación systray
Estado del servicio Agentlaunchctl list com.datadoghq.agent o a través de la aplicación systray
Página de estado del Agent en ejecucióndatadog-agent status o con la GUI web
Enviar un flaredatadog-agent flare o con la GUI web
Mostrar el uso de comandosdatadog-agent --help
Ejecutar un checkdatadog-agent check <CHECK_NAME>
DescripciónComando
Ejecutar el Agent como un serviciodatadog-agent start
Detener la ejecución del Agent como serviciodatadog-agent stop
Reiniciar la ejecución del Agent como serviciodatadog-agent restart
Estado del servicio Agentdatadog-agent status
Página de estado del Agent en ejecucióndatadog-agent info
Enviar un flaredatadog-agent flare
Mostrar el uso de comandosno aplica
Ejecutar un checkdatadog-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:

  • ~/.datadog-agent/conf.d/

Los archivos y carpetas de configuración del Agent se encuentran en:

  • ~/.datadog-agent/datadog.conf

Archivos de configuración para las integraciones:

  • ~/.datadog-agent/conf.d/

Desinstalar el Agent

Instalación por un solo usuario

Para eliminar el Agent y todos sus archivos de configuración:

  1. Detén y cierra el Datadog Agent con el icono en forma de hueso en la bandeja.
  2. Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.
  3. 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
    
  4. 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:

  1. Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.
  2. 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
    
  3. Reinicia el equipo para que se apliquen los cambios.
  1. Detén y cierra el Datadog Agent con el icono en forma de hueso en la bandeja.
  2. Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.
  3. 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