Acceder a la API de métricas

Como administrador, puede usar la API de métricas con consultas PromQL para consultar y obtener directamente métricas sin procesar que puedan utilizar visores o aplicaciones gráficas de terceros, como Grafana, que pueden estar ejecutándose dentro o fuera del clúster.

El sistema de monitorización Promethetheus se utiliza en la API de métricas para recopilar estas métricas de cada pod de servicio SIG y conservar la información en una base de datos de serie temporal. El visor de métricas registra la API de métricas como data store, de modo que puede consultar la API de métricas para obtener estadísticas de uso.

La API de métricas se expone en la API usagestatistics del directorio del administrador. Para acceder a la API de métricas, siga estos pasos:

  1. Vaya a la API usagestatistics en el directorio de administrador: https://organization.example.com/<context>/admin/usagestatistics.
  2. Haga clic en API de métricas REST.

    La aplicación API de métricas se abre en una pestaña nueva.

  3. Inicie sesión en la página web Prometheus.

    De forma predeterminada, las credenciales generadas por el sistema se utilizan para iniciar sesión. Antes de iniciar sesión en el cuadro de mando Prometheus, configure su organización y actualice sus credenciales. Para actualizar estas credenciales, utilice la operación Actualizar credenciales en admin/usagestatistics. La nueva contraseña debe tener como mínimo ocho caracteres y debe contener al menos una letra (A-Z, a-z), un número (0-9) y un carácter especial.

Métricas sin procesar recopiladas por la API de métricas

Las métricas sin procesar recopiladas por la API de métricas se describen en la siguiente tabla:

N.º SNombre de la métricaDescripciónTipo

1

requests

Solicitudes que se pueden utilizar para buscar el índice de solicitudes.

Contador

2

requests_succeeded

Solicitudes satisfactorias que se pueden utilizar para buscar el índice de solicitudes satisfactorias.

Contador

3

requests_failed

Solicitudes fallidas que se pueden utilizar para buscar el índice de solicitudes fallidas.

Contador

4

requests_usage_timedout

Solicitudes cuyo tiempo de uso expiró y que se pueden utilizar para buscar el índice de solicitudes cuyo tiempo de uso expiró.

Contador

5

requests_wait_timedout

Solicitudes cuyo tiempo de espera expiró y que se pueden utilizar para buscar el índice de solicitudes cuyo tiempo de espera expiró.

Contador

6

requests_response_time_seconds

Tiempos de respuesta en segundos.

Las muestras, observaciones y recuentos se incluyen en buckets de: 0,05, 0,1, 0,25, 0,5, 0,75, 1, 2,5, 5, 7,5, 10 e Inf.

Histograma

Etiquetas capturadas por la API de métricas

Junto con cada métrica sin procesar recopilada por la API de métricas, las etiquetas que se describen en la siguiente tabla también se recopilan y se pueden utilizar para consultar métricas de la API de métricas con consultas PromQL y filtros de resultados:

Nombre de etiquetaDescripción

nodeName

El nombre del equipo con el pod de servicio que gestiona la solicitud.

podName

El nombre del pod de servicio que gestiona la solicitud.

apiType

La API en la que se recopila la métrica.

El valor actual posible es service, que representa una solicitud de servicio.

folderName

El nombre de la carpeta donde se crea el servicio.

serviceName

El nombre del servicio, incluido el nombre de la carpeta en la que reside el servicio.

serviceType

El tipo de servicio, por ejemplo, un MapService o FeatureService.

Operación

La operación solicitada, por ejemplo, una consulta o exportación.

Nota:

La información de operaciones solo está disponible para solicitudes REST. Las solicitudes SOAP solo devuelven un valor de soap.

orgId

El Id. de la organización.

nombre de usuario

El nombre de usuario del usuario que realiza la solicitud.