Cómo investigar los problemas

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

El panel Investigate te permite ver tablas dinámicas de métricas y atributos para todo el tráfico de API y comparar la actividad relacional entre métricas para investigar y diagnosticar problemas más rápido. Puedes acceder a los datos de los últimos 30 días en el panel.

Selecciona Analyze > API Monitoring > Investigate en la IU de Edge para abrir el panel Investivate. El panel tiene dos áreas principales:

  • Status Code te permite investigar las métricas de código de estado para los proxies de API y los servicios de destino.
  • La latencia te permite investigar los problemas de latencia para los proxies de API y los servicios de destino.

También puedes investigar problemas causados por una alerta específica en el panel Investigar. Cuando se produce una alerta, haz clic en su nombre en la página Alert History para abrirla en el panel de Invesitgate.

Usa el panel Investigar para diagnosticar un problema

Por ejemplo, recibirás una alerta que indica que la tasa de error 5xx supera el umbral especificado. Para investigar este problema, puedes realizar las siguientes tareas en el panel Investigar:

  1. Consulta la matriz de código de error frente al tiempo para ver la actividad del código de falla en la última hora.
  2. Cambia a la matriz código de falla frente al estado HTTP para identificar códigos de estado HTTP específicos asociados con los códigos de falla cuyos recuentos aumentaron más de la última hora, como se identifica en el paso anterior.
  3. Cambia a la matriz de código interno en comparación al proxy para identificar los proxies de API que activan los códigos de falla identificados en el paso anterior.
  4. Haga clic en una casilla de la matriz que está asociada con un proxy de API con un gran volumen de códigos de falla para ver más detalles y registros de acceso.
  5. Configura una alerta y crea un informe personalizado para ayudarte a diagnosticar el problema.
  6. troubleshoot del proxy de API usando el seguimiento y otras herramientas para identificar una solución al problema.

Usa el panel de código de estado

El panel Código de estado te permite investigar las métricas de código de estado para los proxies de API y los servicios de destino de tu organización. Puedes ver las métricas del código de estado para un período de una o cuatro horas en cualquier momento de los últimos 30 días.

Explora el panel Código de estado

Para mostrar el panel Código de estado, selecciona Analyze > API Monitoring > Investigate en la IU de Edge. El panel Código de estado muestra de forma predeterminada:

página del código de estado

Como se destaca en la figura, el panel Investigar te permite hacer lo siguiente:

  • Configura cada matriz mediante la configuración de sus ejes "x" e "y" para comparar la actividad relacional entre las métricas y obtener más estadísticas.
  • Identifica rápidamente las métricas que tienen los volúmenes relativos más altos según el sombreado de color de un bloque. Cuanto más oscuro sea el bloque, más alto será el volumen relativo.
  • Haz clic en un bloque de la matriz para ver los detalles de la métrica.
  • Filtra los datos según lo siguiente:
    • Entorno
    • Región
    • Proxy
    • Códigos de estado (incluidos todo el tráfico, todos los errores, 2xx, 4xx o 5xx)
    • Fecha y hora de los últimos 30 días
    • Ventana de 1 hora o 4 horas

Usa el panel para realizar las siguientes tareas con rapidez:

Configura la matriz del código de estado

Cuando seleccionas el panel Código de estado, aparecen las siguientes matrices de forma predeterminada:

  • Código de falla frente al tiempo
  • Código de error frente al estado de HTTP
  • Fuente de error frente al proxy de API

Configura cada matriz a fin de comparar dos de las siguientes métricas. Para ello, selecciona un valor para las listas desplegables x- e y-axis:

  • Código de falla
  • Política de fallas
  • Fuente de la falla
  • Estado de HTTP
  • Proxy
  • Tiempo
  • Región
  • Objetivo (Target service o la política ServicePrompt. Si el objetivo es una política ServiceReferencia, el valor que se muestra tiene el prefijo sc://. Por ejemplo, sc://my.endpoint.net).

Configurar matriz

Visualiza los detalles de la métrica de código de estado

Haz clic en el bloque de la matriz para ver los detalles de una métrica en particular.

Selecciona Bloquear

Los detalles relacionados con la causa sospechosa se muestran en el panel derecho, incluidos los siguientes:

  • Entorno
  • Organización
  • Región
  • Fuente de la falla (infraestructura de Apigee, destino o proxy)

También se pueden incluir los siguientes detalles:

  • Política de fallas: Información sobre la política que activó el error en el entorno de ejecución, incluido el tipo de política (nombre interno) y el nombre de la política definida por el usuario. Define el nombre cuando adjuntas la política al flujo del proxy de la API.
  • Nombre del proxy
  • Código de estado HTTP
  • Código de falla

Si la cardinalidad es mayor que una para una métrica específica, el panel de detalles puede incluir detalles de distribución de errores, como la distribución de la app de desarrollador, la distribución por política de falla, la distribución por error de código, la distribución por estado HTTP, etcétera. Por ejemplo:

Distribución por

Si la fuente de fallas es el objetivo, el panel de detalles incluirá una tasa de error por objetivo. Por ejemplo:

Tasa de errores por objetivo

Usa el panel de Latencias

En el panel Latencia, se muestra la información de latencia de los proxies de API y los servicios de destino de tu organización. Puedes investigar las métricas de latencia para un período de una hora en cualquier momento de los últimos 30 días.

Explora el panel de Latencias

Para mostrar el panel Latency, selecciona Analyze > API Monitoring > Investigate en la IU de Edge. El panel Código de estado se muestra de forma predeterminada. Selecciona Latencia en el área de filtro para mostrar el panel Latencia:

página de latencias

Cuando seleccionas el panel de Latencias, las siguientes matrices aparecen de forma predeterminada:

  • Proxy frente a tiempo (latencia máxima en milisegundos)
  • Latencia de proxy frente a latencia total (latencia máxima en milisegundos)
  • Latencia de proxy frente a la de todos los destinos (latencia máxima en milisegundos)

Usa el cuadro desplegable Proxy para seleccionar Destino y ver las latencias de destino.

De forma predeterminada, el panel de Latencias muestra información de los 10 proxies con la latencia P99 total más alta de la hora anterior. Como alternativa, usa el cuadro desplegable los 10 principales para seleccionar un proxy o una colección específica.

El panel de Latencias tiene todas las funciones del panel de código de estado, con las siguientes diferencias:

  • Solo debes configurar el percentil de latencia de respuesta total (p50, p90, p95, p99).
  • Solo puedes seleccionar un período de una hora para las métricas de latencia.
  • No puedes seleccionar Cualquiera para Región en los filtros. Debes seleccionar una región específica para ver.

Visualiza los detalles de las métricas de latencia

Haz clic en el bloque de la matriz para ver los detalles de una métrica en particular.

Selecciona Bloquear

Los detalles relacionados con la latencia de un proxy (línea azul) y un destino (línea púrpura) se muestran en el panel derecho, incluido lo siguiente:

  • Latencia total (latencia del proxy más la latencia de destino)
  • Latencia por objetivo (tiempo de respuesta objetivo)
  • Distribución por estado HTTP

Coloca el cursor sobre el gráfico para ver información detallada:

Vista de la métrica de latencia

El gráfico Latencia por objetivo muestra los 16 objetivos principales en función de la latencia máxima, con un gráfico por objetivo. Desplaza el mouse sobre un gráfico o selecciona la lista desplegable para determinar el gráfico que corresponde a cada objetivo.

Visualiza los registros de los detalles de las métricas

Cuando veas detalles de métricas de códigos de estado o latencia, haz clic en Ver registros para ver todos los registros de la métrica seleccionada:

Selección de registros

Se abrirá el cuadro de diálogo Registros de tráfico y se mostrará un máximo de 1,000 entradas de registro. Haz clic en una entrada de registro para expandir sus detalles en la lista:

Registros

Puedes filtrar aún más los registros de la siguiente manera:

  • Fuente de tráfico
  • Tipo de error
  • Tiempo de respuesta mínimo

No puedes descargar los datos de registro desde el cuadro de diálogo Registros de tráfico. Sin embargo, puedes crear un informe personalizado o descargar los datos de estadísticas en tu propio repositorio de datos, como Google Cloud Storage o BigQuery, para realizar tu propio análisis de datos.

Crea un informe personalizado desde el panel Investigar

Crea un informe personalizado basado en el conjunto de condiciones seleccionado. Puedes editar el informe personalizado después de crearlo para agregar o borrar métricas y dimensiones, según sea necesario. Por ejemplo, es posible que desees limitar tu investigación a un token de acceso, una app de desarrollador o un proxy de API en particular. Para obtener más información, consulta Referencia de métricas, dimensiones y filtros de Analytics.

Para obtener más información, consulta Crea informes personalizados.

Para crear un informe personalizado, sigue estos pasos:

  1. Haz clic en un bloque de la matriz para ver más detalles.

    Selecciona Bloquear

  2. En el panel derecho, haz clic en Crea informe personalizado.

    Crea el informe

    La página de informes personalizados se muestra en una pestaña nueva con campos relevantes antes propagados.

    Nota: Consulta Crea informes personalizados para obtener más información sobre la configuración predeterminada de los informes personalizados.

    Edita el informe

  3. Edita el informe personalizado según sea necesario. Consulta el artículo Cómo administrar informes personalizados.

  4. Haz clic en Guardar para guardar el informe personalizado.

El informe se ejecuta con los datos recopilados en la última hora de forma predeterminada, y los datos se muestran en el panel de informes personalizados. Consulta Explora el panel de informes personalizados.

En la página Informes, los informes personalizados que se generan con la supervisión de API se nombran con el siguiente formato: API Monitoring Investigate Generated.

Investiga una alerta específica

Para investigar una alerta específica, selecciona el nombre de la alerta en la página Historial de alertas. Aparecerá el panel Investigar. Ten en cuenta que contiene un gráfico en la parte superior del panel y que solo incluye información específica sobre la alerta:

investigar la página de alertas

  • Visualiza los detalles del tráfico de la API en el momento en que se activó la alerta.
  • Consulta información contextual sobre la alerta, incluida la hora en la que se activó, en el centro del gráfico.
  • Haz clic en Detalles de la condición para mostrar los detalles de la condición de alerta en una ventana emergente.
  • Haz clic en Guía (si está disponible) para ver la guía de la alerta:

    vínculo a la guía

  • Haz clic en Administrar alerta para editar la alerta.

  • Haz clic en Ver informe (si está disponible) para ver un informe personalizado.

  • Habilita o inhabilita la actualización automática de la página, según sea necesario.