Documentación de Oracle Cloud Infrastructure

Configuración de agentes de gestión para recopilar métricas de Prometeo

El servicio Oracle Cloud Infrastructure Management Agents (agentes de gestión) soporta la recopilación de datos de métricas de rendimiento de series temporales de cualquier recurso que muestra datos de métricas en formato Prometheus. Para obtener más información sobre Prometheus, consulte la documentación oficial de Introducción a Prometheus.

Prometheus y Management Agents

En los siguientes pasos se describe cómo recopilar métricas de Prometheus con agentes de gestión:

  • Paso 1. Instale Management Agent con acceso al punto final de métricas de Prometheus.
  • Paso 2. Activar métricas de Prometheus
  • Paso 3. Configurar un origen de datos Prometheus
  • Paso 4. Creación de un panel de control de Prometheus

    Paso 1: Instalar Management Agent

    En primer lugar, debe instalar un agente de gestión para registrar agentes con Oracle Cloud Infrastructure (OCI).
    En función del entorno, puede seleccionar una de las siguientes formas de instalar Management Agent:
    • Instalación de un Management Agent en una instancia de OCI.

      Si tiene una instancia informática de OCI, debe seguir las instrucciones para activar Management Agent en una instancia informática de OCI. Para obtener información sobre los requisitos y el proceso de instalación, consulte Despliegue de instancias de Management Agent en instancias informáticas.

    • Instalar un agente de gestión en una instancia que no sea de OCI.

      Si tiene una máquina virtual independiente, debe seguir las instrucciones para instalar un agente de gestión en una máquina virtual. Debe instalar Management Agent en la misma VM o en una VM con acceso al punto final de Prometheus. Para obtener información sobre los requisitos y el proceso de instalación, consulte Instalación de instancias de Management Agent.

      Creación de un grupo dinámico y asociación de una política

      A continuación, cree un grupo dinámico de Management Agent con la siguiente política.
      1. Cree un grupo dinámico para las instancias de Management Agent si aún no existe. Por ejemplo: Management-Agent-Dynamic-Group. Sustituya <AGENT_COMPARTMENT_OCID> por el OCID de compartimento para Management Agent. 
        ALL {resource.type='managementagent' resource.compartment.id='<AGENT_COMPARTMENT_OCID>'}
      2. Asocie la siguiente política para permitir que el agente publique las métricas en el espacio de nombres de OCI Monitoring. 
        allow dynamic-group Management-Agent-Dynamic-Group to use metrics in compartment <METRIC_COMPARTMENT_OCID> where target.metrics.namespace = '<OCI_MONITORING_NAMESPACE>'
      Nota

      Si desea ver las métricas inmediatamente, debe reiniciar Management Agent.
      Para obtener más información sobre grupos dinámicos, consulte Gestión de grupos dinámicos y Gestión de políticas.

      Paso 2. Activar métricas de Prometheus

      Para activar las métricas de Prometheus para el software o hardware, vaya a las instrucciones oficiales de lo que desea supervisar para determinar qué método utilizar.

      Por ejemplo, en esta entrada del blog se explica Cómo configurar contenedores Docker en Oracle Cloud para utilizar métricas de Prometheus. En este ejemplo, las instrucciones de Docker del sitio web oficial contienen las instrucciones más recientes sobre cómo activar Prometheus en un contenedor de Docker.

      Paso 3. Configurar un origen de datos de Prometheus

      A continuación, en Oracle Cloud puede configurar Management Agent para recopilar métricas de Prometheus agregando y configurando un origen de datos de Prometheus en la consola de Oracle Cloud.

      En este vídeo se muestra cómo configurar un origen de datos de Prometheus. En este vídeo, se configura un origen de datos Prometheus para un servicio de Kafka. El proceso para agregar, editar y configurar un origen de datos en la consola de Oracle Cloud es el mismo para cualquier origen de datos que muestre métricas de Prometheus en una URL.

      Para agregar y configurar un origen de datos de Prometheus:

      1. En la consola de Oracle Cloud, vaya al menú de navegación, seleccione Observación y gestión, vaya a Agentes de gestión y, a continuación, seleccione Agentes.
      2. Seleccione Agentes y gateways, seleccione el compartimento necesario y, a continuación, seleccione el agente.
      3. Seleccione Gestionar orígenes de datos y, a continuación, seleccione Agregar origen de datos.
      4. Seleccione Prometheus en la lista desplegable Tipo de origen de datos, agregue el espacio de nombres de métrica, la URL y seleccione el compartimento de métrica. Si es necesario, puede agregar dimensiones de métricas personalizadas o definir cualquier propiedad opcional. Para obtener una lista de opciones, consulte Required Data Source Properties y Optional Data Source Properties.
        Nota

        Los valores de Espacio de nombres de métrica y Compartimento de métrica deben ser los mismos que los valores de la política.

      5. Haga clic en Agregar.

        Ahora, si se ha configurado correctamente, después de unos minutos las métricas se mostrarán en el servicio OCI Monitoring.

        Nota

        Si faltan las políticas necesarias, recibirá mensajes de error HTTP 404 NotAuthorized en los logs de Management Agent. Para obtener más información, consulte Creación de un grupo dinámico y asociación de una política.

      Para ver o editar un origen de datos de Prometheus:

      Después de agregar un origen de datos, puede ir a Gestionar orígenes de datos y, a continuación, seleccionar la elipse vertical junto al origen de datos que desea ver o editar.

Propiedades de origen de datos necesarias

Las siguientes propiedades son necesarias al crear un origen de datos Prometheus.

Nombre Unidades/Formato Descripción
url Cadena URL en la que el Exportador de Prometheus publica sus métricas. Solo admite solicitudes HTTP, por ejemplo:

http://localhost:9100/metrics
Espacio de nombres Cadena Espacio de nombres de supervisión de OCI en el que se cargan las métricas analizadas.
compartmentId Cadena OCID del compartimento en el que se cargan las métricas analizadas.

Propiedades de Origen de Datos Opcionales

Las siguientes propiedades son opcionales al crear un origen de datos Prometheus. Para recopilar un rango más específico de métricas de Prometheus, puede agregar cualquiera de estas propiedades opcionales al crear el origen de datos.

Nombre Unidades/Formato Descripción
allowMetrics Cadena: lista de nombres de métricas separadas por comas El conjunto completo de métricas raspadas deseadas. Utilice esta propiedad para limitar el juego de métricas cargadas si es necesario.
connection-timeout Número en milisegundos Timeout para conectarse al punto final del exportador de Prometheus.
metricDimensions Cadena: lista de nombres de propiedad separados por comas Nombres de otras propiedades proporcionadas por el usuario expresados como valores fijos que se utilizarán como dimensiones para cada punto de datos cargado.
URL de Proxy Cadena - URL URL del proxy de red que proporciona acceso al punto final del exportador de Prometheus, propiedad de URL necesaria.
límite de datos de lectura Número en kilobytes Límite de los datos que se envían. Por ejemplo, si se introducen 400 KB, el valor no superará el límite fijo del agente de gestión, 400 KB de espacio en disco.
timeout de lectura Número en milisegundos Timeout para leer la respuesta del punto final del exportador de Prometheus.
resourceGroup Cadena. Incluye solo caracteres alfanuméricos, puntos (.), guiones bajos (_), guiones (-) y signos de dólar ($). Grupo de recursos del servicio OCI Monitoring.

Si se especifica, el grupo de recursos se asignará a cada una de las métricas emitidas.
scheduleMins Intervalo de desecho en minutos Si se especifica este valor, la recopilación o el raspado de datos se producen en este intervalo de tiempo específico.

El valor mínimo es de 1 minuto.

Si no se especifica este valor, el valor por defecto es 5 minutos.

Nota: La reducción del intervalo de recopilación puede tener un impacto positivo en el rendimiento de la CPU.

Ejemplo: scheduleMins=1

Creación de un panel de control de Prometheus

Una vez completados los pasos anteriores para configurar Management Agent para exportar las métricas de Prometheus, puede utilizar el servicio OCI Management Dashboards para crear un panel de control y visualizar las métricas de Prometheus. Puede configurar un widget de explorador de datos de métricas para cada métrica que desee visualizar. Para obtener información, consulte Creación de un widget del explorador de datos de métricas.