Cuando integra la cuenta de OCI para enviar logs a New Relic, OCI es la fuente de datos y New Relic es el destino. En el medio, una función de New Relic (el reenviador de logs) extrae los logs de OCI y los entrega a New Relic. Si esa función tiene problemas, por ejemplo, un secreto que no puede leer, un lote que no puede decodificar o una entrega que no puede completar, los logs de OCI dejan de fluir, pero nada en OCI o New Relic le indica el motivo.
Para detectar este tipo de falla antes de que le cueste datos de logs, el reenviador de logs puede emitir métricas sobre su propio estado. Este documento cubre:
- Habilitar las métricas de autoobservabilidad en la función del reenviador de logs, para que comience a informar señales como recuentos de invocaciones, errores de entrega y retraso en la canalización, el tipo de detalle que le indica en qué parte de la canalización ocurrió una falla.
- Importe un dashboard prediseñado que convierte esas señales en gráficos, para que pueda detectar una anomalía de un vistazo en lugar de indagar en los datos de métrica sin procesar.
Requisitos previos
Antes de comenzar, asegúrese de tener:
- La función del reenviador de logs de OCI que ya desplegó con Resource Manager, Terraform o la configuración manual
- El ID de la cuenta de New Relic, para usar al importar el dashboard
Habilitar las métricas de autoobservabilidad
En las variables de configuración de la función de logs, el mismo lugar donde configuró VAULT_REGION, SECRET_OCID y las demás variables de logging, agregue:
FORWARDER_METRICS_TIER: controla qué métricas de autoobservabilidad emite el reenviador. Consulte los niveles de métricas para saber qué recopila cada configuración.
Si configura la integración con Resource Manager o Terraform, FORWARDER_METRICS_TIER es la única variable que necesita agregar — TENANCY_NAME y COMPARTMENT_NAME se resuelven automáticamente.
Si configura la integración manualmente, agregue también:
TENANCY_NAME: identifica el arrendamiento de OCI por el nombre de visualización, agregando una etiqueta a la métrica del reenviador para que pueda diferenciar los arrendamientos si monitorea más de uno.COMPARTMENT_NAME: identifica, por nombre de visualización, el compartimento donde desplegó la función de logs, agregando etiquetas a las métricas para los desgloses por compartimento. Si desplegó en el compartimento raíz del arrendamiento, utilice el mismo valor queTENANCY_NAME.
Importante
New Relic factura estas métricas de autoobservabilidad en la ingesta, al igual que cualquier otro dato de métrica.
Niveles de métricas
FORWARDER_METRICS_TIER le permite equilibrar la visibilidad y el costo. Acepta uno de los siguientes valores:
none: desactiva las métricas de autoobservabilidad por completo.basic(predeterminado): recopila métricas de estado principales: recuentos de invocaciones, registros recibidos, entregados y descartados, duración de la entrega y retraso del pipeline.advanced: recopila todo enbasic, además de métricas de ajuste más detalladas: volúmenes de bytes, recuentos de errores de decodificación y serialización, comportamiento de procesamiento por lotes, clases de errores de entrega, duración de la ejecución de funciones, fallas de recuperación de secretos y tasa de aciertos de caché del cliente.
Importar el dashboard de observabilidad
Importante
Establezca FORWARDER_METRICS_TIER en basic o advanced antes de importar el dashboard. Si lo establece en none, el dashboard no tendrá ningún dato para mostrar.
Para importar el dashboard:
- Abra el archivo
oci-log-forwarder-metrics-dashboard-template.jsonen el respositoriooci-log-integrationde GitHub y copie su contenido. - En el JSON copiado, busque y reemplace cada aparición de
YOUR_ACCOUNT_IDpor el ID de cuenta de New Relic. - Vaya a one.newrelic.com > All capabilities > Dashboards.
- En la esquina superior derecha, haga clic en Import dashboard.
- Pegue el JSON editado.
- Elija la configuración de cuenta y permisos para el dashboard y, a continuación, haga clic en Save.
El dashboard se completa después de que la función de logs procesa al menos una invocación con las métricas habilitadas.
Solucionar problemas con el dashboard
Si los logs de OCI dejan de llegar a New Relic, revise este dashboard primero. Un pico en las fallas de obtención de secretos o en los errores de entrega indica un problema en el pipeline de reenvío, como el hub del conector de servicios, los grupos de logs o la función, en lugar de en OCI o en el propio New Relic. Después de solucionar el problema subyacente, por ejemplo, una política o un permiso del almacén de claves, los logs se reanudan sin redesplegar nada.
Si no ve ningún dato de log en absoluto y aún no ha confirmado que la integración base funciona, comience con nuestros procedimientos estándar de resolución de problemas de logs en su lugar.
Próximos pasos
Continúe explorando la integración de OCI:
- Revise la lista completa de métricas que New Relic recopila de OCI.
- Consulte la resolución de problemas generales de la integración de OCI si la integración base en sí no funciona.