Métricas de Management Agent
Puede supervisar el estado, la capacidad y el rendimiento de los agentes de gestión mediante métricas, alarmas y notificaciones.
Para obtener más información, consulte Visión general de Monitoring y Visión general de Notifications.
En este tema se describen las métricas emitidas por el servicio Management Agent en el espacio de nombres de métricas de oci_managementagent.
Visión general de las métricas del servicio Management Agent
Management Agent proporciona un canal unidireccional que permite a los servicios de Oracle Cloud Infrastructure interactuar con la máquina virtual del cliente de forma segura. El agente funciona con las topologías de red más sencillas sin necesidad de ninguna configuración especial en las máquinas virtuales. El agente proporciona un modelo ampliable para que los servicios de Oracle Cloud Infrastructure puedan recopilar métricas de rendimiento y ejecutar el trabajo.
Las métricas de servicio para el recurso Management Agent permiten a los usuarios visualizar el consumo de recursos del agente en términos de CPU, memoria y disco.
Requisitos
-
Políticas de IAM: para supervisar los recursos, debe contar con el tipo de acceso necesario en una política escrita por un administrador, tanto si utiliza la consola como la API de REST con un SDK, una CLI u otra herramienta. La política debe otorgarle acceso a los servicios de supervisión y a los recursos que se supervisen. Si intenta realizar una acción y obtiene un mensaje de que no tiene permiso o no está autorizado, confirme con el administrador el tipo de acceso que se le ha otorgado y en qué compartimento debe trabajar. Para obtener más información sobre las autorizaciones de los usuarios para la supervisión, consulte la sección Autenticación y autorización del servicio relacionado: Monitoring o Notifications. Para obtener información sobre las políticas para agentes de gestión, consulte Configuración del servicio del agente de gestión de Oracle Cloud Infrastructure.
-
Las métricas que se muestran en esta página están disponibles automáticamente para cualquier agente de gestión que instale. No es necesario que active la supervisión en el recurso para obtener estas métricas.
Métricas disponibles: oci_managementagent
El servicio Management Agent emite métricas al espacio de nombres de métricas oci_managementagent en el servicio Monitoring.
Las métricas que se muestran en las siguientes tablas están disponibles automáticamente para los agentes de gestión que instale. No es necesario que active la supervisión para obtener estas métricas. También puede utilizar el servicio Supervisión para crear consultas personalizadas.
Dimensiones
Las métricas de Management Agent incluyen las siguientes dimensiones:
-
AGENTHOSTNAME: nombre de host en el que está instalado el agente de gestión.
-
RESOURCEID: OCID del recurso del agente de gestión.
Métricas
| Nombre de la métrica | Nombre mostrado de la métrica | Unidad | Frecuencia | Descripción | Dimensiones |
|---|---|---|---|---|---|
agentHealthStatus |
Estado del agente | No aplicable | 1 minuto |
El agente está activo y se está comunicando con el servicio Monitoring. El valor de estado es un número constante (1) para representar que el agente está activo y puede cargarlo en el servicio Monitoring. La ausencia de puntos de datos en el servicio Monitoring implica que el agente no se puede comunicar con el servicio Monitoring. No debe implicar que el agente esté caído. |
|
diskUsageUsed |
Uso de disco de agente | Megabytes | 1 hora | Cantidad total de disco usado en "agent_inst". |
|
diskUsageFree |
Espacio disponible en disco de agente | Megabytes | 1 hora | Cantidad de espacio de disco disponible en el volumen. |
|
diskUsageInstallSize |
Uso de disco para instalación | Megabytes | 1 hora | Cantidad total de disco utilizada en agentBaseDir. |
|
uploadBufferPctusedofmaxbuffer |
Porcentaje de almacenamiento temporal usado | Porcentaje | 15 minutos | Cantidad de espacio en disco que utiliza el agente para almacenar contenido temporalmente mientras espera a que el servicio Monitoring esté disponible. Este número se expresa como un porcentaje del límite máximo en el agente (límite por defecto: 100 MB). |
|
usageCpu |
Uso de CPU de agente | Porcentaje | 1 minuto | Porcentaje de uso de CPU del agente. |
|
usageRss |
Uso de memoria de agente | Megabytes | 1 minuto | Cantidad de memoria consumida por la JVM del agente. Este número representa el tamaño del juego residente en la memoria principal. |
|
El intervalo de alarma debe ser mayor que la frecuencia con la que se emiten las métricas. Asegúrese de definir intervalos de alarma mayores que la frecuencia con la que se emiten las métricas.
Configuración de alarmas por defecto mediante la aplicación Marketplace
Para configurar alarmas por defecto con un umbral de métricas predefinidas automáticamente, puede utilizar la aplicación Alarmas por defecto para Management Agent desde Oracle Cloud Infrastructure (OCI) Marketplace. Esta aplicación de Marketplace permite configurar automáticamente varias alarmas listas para usar para las métricas de Management Agent y Log Analytics.
Consulte Visión general de Marketplace para obtener una descripción completa de cómo utilizar Marketplace.
-
Una forma sencilla de automatizar la configuración y el control de varias métricas recomendadas por defecto.
- Cree alarmas por defecto para todos los agentes de gestión del arrendamiento (compartimento raíz) en un solo paso.
- Las definiciones de alarma se crean previamente antes de instalar los agentes de gestión.
- Uso del gestor de recursos y las pilas (configuraciones de Terraform) para simplificar la configuración (una configuración automática realizada por el gestor de recursos que permite personalizar las configuraciones de alarmas listas para usar e iniciar la supervisión inmediatamente).
Alarmas por defecto para la aplicación Marketplace del agente de gestión
- Alarmas del agente de gestión
- Disponibilidad de agente.
- Uso de CPU.
- Espacio en disco.
- Uso de memoria de JVM.
- Alarmas de Log Analytics
- Tamaño de datos de carga de Log Analytics.
- Fallo de carga de Log Analytics.
- Tema Destino de notificación (si la opción crear nuevo seleccionada) sin una suscripción. Esto forma parte del servicio OCI Notifications, que permite configurar canales de comunicación para publicar mensajes mediante temas y suscripciones. Para obtener más información, consulte Notificaciones.
- Definiciones de alarma para las métricas seleccionadas. Por defecto, se crean cuatro alarmas de métricas de Management Agent (alarmas de disponibilidad, CPU, disco y memoria) y dos alarmas de métricas de Log Analytics (tamaño de datos de carga de Log Analytics y alarmas de fallos de carga de Log Analytics).
Arquitectura
Management Agent está totalmente integrado con otros servicios de Oracle Cloud Infrastructure, lo que facilita la automatización de la configuración de alarmas de métricas para Log Analytics mediante Resource Manager y pilas. Una vez definidas las alarmas, se supervisan mediante el servicio Monitoring y se les notifica cuando las métricas cumplen los disparadores especificados por la alarma mediante el servicio Notifications.
Requisitos
- El usuario debe tener permisos o políticas para gestionar agentes de gestión, métricas y temas de notificación.
- El usuario debe formar parte del grupo de administradores o tener permiso para llamar a la pila del gestor de recursos.
Si el usuario no forma parte del grupo Admin, debe tener los siguientes permisos para llamar a la pila Resource Manager:
# Policies required to manage stacks and jobs in OCI Resource Manager ALLOW GROUP <User-Group> TO MANAGE orm-stacks IN TENANCY ALLOW GROUP <User-Group> TO MANAGE orm-jobs IN TENANCY # Policies required to read and manage IAM resources ALLOW GROUP <User-Group> TO READ compartments IN TENANCY ALLOW GROUP <User-Group> TO READ tenancies IN TENANCY ALLOW GROUP <User-Group> TO MANAGE dynamic-groups IN TENANCY ALLOW GROUP <User-Group> TO MANAGE policies IN TENANCY # Policies required to manage Management Agents ALLOW GROUP <User-Group> TO MANAGE management-agents IN TENANCY ALLOW GROUP <User-Group> TO READ metrics IN TENANCY # Policies required to create and manage alarms and notification topics ALLOW GROUP <User-Group> TO MANAGE alarms IN TENANCY ALLOW GROUP <User-Group> TO USE ons-topics IN TENANCYNota
Para restringir políticas explícitamente a compartimentos específicos, utilice<COMPARTMENT_NAME>en lugar deTENANCY. Por ejemplo:ALLOW GROUP <User-Group> TO MANAGE ALARMS IN COMPARTMENT <COMPARTMENT_NAME>.Para obtener más información sobre la creación y gestión de grupos de usuarios, consulte Gestión de grupos.
Despliegue de alarmas por defecto para el agente de gestión mediante la aplicación Marketplace
-
Inicie sesión en Oracle Cloud.
-
Abra el menú de navegación. En Marketplace, haga clic en Marketplace para ver todas las aplicaciones.
-
Vaya al cuadro de búsqueda, escriba Management Agents y seleccione la lista de pila Default Alarms for Management Agents.
Se muestran los detalles de la lista.
-
Seleccione Versión de pila y Compartimento.
-
Revise las condiciones de uso de Oracle y active la casilla de control He revisado y aceptado.
-
Haga clic en Iniciar pila.
Aparece la página Gestor de recursos, que muestra el proceso Crear pila.
-
En el paso 1 Información de pila, revise la información de pila.
-
En Nombre, revise el nombre rellenado automáticamente para identificar la pila.
-
En Descripción, agregue una descripción para el despliegue de pila opcionalmente.
-
En Crear en compartimento, seleccione un compartimento de la lista desplegable.
-
Opcionalmente, especifique etiquetas de espacio de nombres para organizar y realizar un seguimiento de los recursos.
-
Haga clic en Siguiente para continuar en el siguiente paso.
-
-
En el paso 2 Configurar variables, revise y actualice la configuración por defecto si es necesario.
- En Configuración necesaria, revise lo siguiente:
-
En Compartimento de agente de gestión, seleccione el compartimento en el que están instalados los agentes de gestión.
- Si se selecciona el compartimento/arrendamiento raíz, se muestra la casilla de control Activar compartimentos de agente de gestión anidados. Desactive esta casilla de control si no desea supervisar los agentes en los subcompartimentos.
- Active la casilla de control Crear nuevo tema para crear un nuevo tema de destino de notificación sin ninguna suscripción. Si ya se ha creado un tema de destino de notificación, desactive esta casilla de control.
- En Identificador de pila, introduzca un nombre único para identificar las alarmas y los temas de notificación que se van a crear.
- En Requisito, revise y confirme las políticas necesarias.
-
- En Configuración de alarmas de agente de gestión, revise las cuatro definiciones de alarma a punto de crearse por defecto.
- Marque Personalizar alarmas de agente de gestión para desactivar o modificar la configuración de cualquier alarma.
Nota
Desactive una casilla de control de alarma si no desea supervisarla (elimínela de la creación de la pila). - Compruebe la alarma de disponibilidad para configurar una alarma para comprobar la disponibilidad del agente de gestión.
- Compruebe la alarma de CPU para configurar una alarma para el porcentaje de CPU del agente de gestión.
- Marque Alarma de disco para configurar una alarma para el espacio en disco del agente de gestión.
- Marque Alarma de memoria para configurar una alarma para comprobar la cantidad de memoria consumida por el agente de gestión.
Nota
Modifique el intervalo de alarma, el umbral y la gravedad de cualquier alarma si es necesario.
- Marque Personalizar alarmas de agente de gestión para desactivar o modificar la configuración de cualquier alarma.
- En Configuración de alarma de Log Analytics, revise las dos definiciones de alarma que se van a crear por defecto.
- Marque Agregar métricas de Log Analytics para configurar las alarmas. Si las alarmas no son necesarias, desactive esta casilla de control.
- Marque Personalizar alarmas de Log Analytics para eliminar o modificar la configuración de cualquiera de las dos alarmas.
- Compruebe la alarma de tamaño de datos de carga de Log Analytics para configurar una alarma para el tamaño de datos de carga de recopilación de logs.
- Compruebe la alarma de fallo de carga de Log Analytics para configurar una alarma cuando haya fallos de carga de recopilación de logs.
- En Configuración necesaria, revise lo siguiente:
-
En el paso 3 Revisar, revise toda la información de forma precisa y completa.
- En ¿Ejecutar aplicación en la pila creada?, desactive la casilla de control Ejecutar aplicación.
Esto garantiza que este proceso solo cree la pila. La pila de aplicación se realizará en otro paso.
- En ¿Ejecutar aplicación en la pila creada?, desactive la casilla de control Ejecutar aplicación.
-
Haga clic en Crear.
Espere hasta que la página indique que la pila se ha creado antes de continuar con el siguiente paso.
-
En la página Detalles de pila, haga clic en Plan para crear un trabajo de plan.
Proporcione un nombre único para el trabajo Plan y haga clic en Plan.
-
Revise la sección de logs en la misma página para asegurarse de que no haya problemas.
-
Seleccione Detalles de pila en el menú de navegación (Gestor de recursos > Pilas > Detalles de pila). En la pila creada, vaya a Información del trabajo y confirme que Estado muestra
Succeeded. -
Vaya al separador Detalles de pila y haga clic en Aplicar.
-
Proporcione un nombre único para identificar el trabajo de aplicación.
-
Mantenga la resolución Aplicar plan de trabajo para aprobar automáticamente la selección.
-
Haga clic en Solicitar para ejecutar el trabajo de aplicación.
Este proceso crea las definiciones de alarma y las enlaza al tema de notificación.
Revise la sección Logs para asegurarse de que no haya problemas.
-
En el separador Información de trabajo, confirme que Estado muestra
Succeeded. -
En el menú de la izquierda Recursos, haga clic en Salidas para ver la información de salida de ejecución.
-
Despliegue de alarmas por defecto para el agente de gestión mediante Github
También puede desplegar la pila Alarmas por defecto para el agente de gestión mediante Github.
-
Vaya a https://github.com/oracle-quickstart/oci-observability-and-management/o11y-ingestion-monitoring
-
Haga clic en Desplegar en Oracle Cloud en la sección README.md.
-
Acepte las condiciones de uso de Oracle y haga clic en Siguiente.
-
Aplique la pila mediante Resource Manager.
Vaya a la sección Desplegar alarmas por defecto para el agente de gestión mediante la aplicación Marketplace. Omita los pasos 1 a 6 y siga las instrucciones que comienzan en el paso 7.
Uso de la consola
-
Abra el menú de navegación. En Observación y gestión, vaya a Supervisión y haga clic en Métricas de servicio.
-
En Espacio de nombre de métrica, seleccione oci_managementagent.
-
En Dimensiones, especifique resourceId y seleccione el
OCIDdel agente de gestión para el que desea mostrar las métricas de servicio.
En la página se muestran gráficos para las métricas emitidas por Management Agent.
Uso de la API
Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Software development kits e interfaz de línea de comandos.
-
La API de Monitoring para las métricas y alarmas
-
La API de Notifications para las notificaciones (utilizadas con alarmas)