Información general

Este check monitoriza las métricas de 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 de Fly.io está incluido en el paquete del Datadog Agent. Recomendamos desplegar una aplicación Fly.io dedicada a ejecutar el check del Datadog Agent. Este agente puede ejecutar el check de Fly.io, que repila métricas de Prometheus así como algunos datos adicionales de la API de máquinas. Además, puedes configurar el Agent para recibir traces (trazas) 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 configurada 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 de 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 traces (trazas) y métricas personalizadas de tus aplicaciones, consulta Traces (trazas) de aplicación.

Configuración

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

2. Reinicia el Agent.

Validación

[Ejecuta el subcomando de estado del Agent(https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) 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.

Traces (trazas) de aplicación

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

1. Instrumenta tu solicitud.

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 informes del mismo host para los logs y las métricas:

   DD_TRACE_REPORT_HOSTNAME="true"
   

   Para utilizar etiquetado de servicio unificado, configura estas variables de entorno:

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

   Para correlacionar logs y traces (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 exponga públicamente los puertos para APM y DogStatsD, si están habilitados.

Recopilación de logs

Utiliza el fly_logs_shipper para recopilar logs de tus aplicaciones Fly.io.

1. Clona el [project (proyecto)] de cargador de logs (https://github.com/superfly/fly-log-shipper).

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 analizará los atributos básicos específicos de los logs de fly. Para analizar completamente todos los atributos de logs, configura ddsource en una integración de logs conocida para 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 cargador de logs.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con asistencia técnica de Datadog.