Información general

Este check monitoriza Fly.io a través del Datadog Agent.

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta en una aplicación Fly.

Instalación

El check Fly.io está incluido en el paquete del Datadog Agent. Recomendamos desplegar una aplicación Fly.io exclusiva para ejecutar el Datadog Agent. Este Agent puede ejecutar el check Fly.io que recopila métricas de Prometheus, así como algunos datos adicionales de la API de máquinas. Además, puedes configurar el Agent para recibir [trazas (traces)(#Application-Traces) y métricas personalizadas de todas tus aplicaciones Fly.io dentro de la organización.

Desplegar el Agent como una aplicación Fly.io

1. Crea una nueva aplicación en Fly.io con la imagen definida como el Datadog Agent al iniciar o proporciona la imagen en el archivo fly.toml:

   [build]
       image = 'gcr.io/datadoghq/agent:7'
   

2. Configura un secreto para tu clave de API Datadog llamada DD_API_KEY y opcionalmente tu sitio como DD_SITE.

3. En el directorio de tu aplicación, crea un archivo conf.yaml para la integración Fly.io, configura la integración y móntala en el directorio conf.d/fly_io.d/ del Agent como conf.yaml:

   instances:
   - empty_default_hostname: true
     headers:
         Authorization: Bearer <YOUR_FLY_TOKEN>
     machines_api_endpoint: http://_api.internal:4280
     org_slug: <YOUR_ORG_SLUG>
   

4. Despliega tu aplicación.

Nota: Para recopilar trazas y métricas personalizadas de tus aplicaciones, consulta Trazas de aplicación.

Configuración

1. Edita el archivo fly_io.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent, para empezar a recopilar tus datos de rendimiento de Fly.io. Para conocer todas las opciones de configuración disponibles, consulta el fly_io.d/conf.yaml de ejemplo.

2. Reinicia el Agent.

Validación

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

Datos recopilados

Métricas

Eventos

La integración Fly.io no incluye eventos.

Checks de servicio

La integración Fly.io no incluye checks de servicios.

Trazas de aplicación

Sigue estos pasos para recopilar trazas de una aplicación en tu entorno Fly.io.

1. Instrumenta tu aplicación.

2. Despliega el Datadog Agent como una aplicación Fly.io.

3. Configura las variables de entorno necesarias en el fly.toml o el Dockerfile de tu aplicación y despliega la aplicación.

   Configura lo siguiente como variable de entorno para enviar métricas a la aplicación del Datadog Agent:

   [env]
       DD_AGENT_HOST="<YOUR_AGENT_APP_NAME>.internal"
   

   Configura la siguiente variable de entorno para asegurarte de que informas logs y métricas del mismo host:

   DD_TRACE_REPORT_HOSTNAME="true"
   

   Para utilizar el etiquetado unificado de servicios, configura estas variables de entorno:

   DD_SERVICE="APP_NAME"
   DD_ENV="ENV_NAME"
   DD_VERSION="VERSION"
   

   Para correlacionar logs y trazas, sigue estos pasos y configura esta variable de entorno:

   DD_LOGS_INJECTION="true"
   

4. Configura las siguientes variables de entorno en tu fly.toml de la aplicación del Datadog Agent y despliega la aplicación:

   [env]
       DD_APM_ENABLED = "true"
       DD_APM_NON_LOCAL_TRAFFIC = "true"
       DD_DOGSTATSD_NON_LOCAL_TRAFFIC = "true"
       DD_BIND_HOST = "fly-global-services"
   

Nota: Asegúrate de que la configuración de tus instancias Fly.io no expone públicamente los puertos para APM y DogStatsD, si están habilitados.

Recopilación de logs

Utiliza el shipper de logs fly para recopilar logs de tus aplicaciones Fly.io.

1. Clona el proyecto del shipper de logs.

2. Modifica el archivo vector-configs/vector.toml para configurar la fuente de logs como fly_io:

   [transforms.log_json]
   type = "remap"
   inputs = ["nats"]
   source  = '''
   . = parse_json!(.message)
   .ddsource = 'fly-io'
   .host = .fly.app.instance
   .env = <YOUR_ENV_NAME>
   '''
   

Esta configuración analiza atributos de los logs específicos de fly. Para analizar completamente los atributos de todos los logs, define ddsource como una integración de logs conocida por cada aplicación utilizando transformaciones vectoriales.

3. Configura secretos para NATS: ORG y ACCESS_TOKEN

4. Configura secretos para Datadog: DATADOG_API_KEY y DATADOG_SITE.

5. Despliega la aplicación del shipper de logs.

Solucionar problemas

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