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:
- Vaya a la API usagestatistics en el directorio de administrador: https://organization.example.com/<context>/admin/usagestatistics.
- Haga clic en API de métricas REST.
La aplicación API de métricas se abre en una pestaña nueva.
- 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 uno de cada uno de los siguientes:
- Letras ASCII de la A a la Z (mayúsculas o minúsculas)
- Números del 0 al 9
- Caracteres especiales admitidos ( # ! % & , - . / : ; < = > @ _ ` ~ y carácter de espacio en blanco)
Precaución:
Los caracteres especiales no admitidos son: ^ ? \ * + \ | $
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.º S | Nombre de la métrica | Descripción | Tipo |
|---|---|---|---|
1 | solicitudes | 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 |
7 | gp_job_wait_time_seconds | Tiempo necesario para seleccionar un trabajo de geoprocesamiento para su ejecución 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 etiqueta | Descripció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. |