Documentação do Oracle Cloud Infrastructure

Configurar Agentes de Gerenciamento para Coletar Métricas do Prometheus

O serviço Oracle Cloud Infrastructure Management Agents (Management Agents) suporta a coleta de dados de métricas de desempenho de séries temporais de qualquer recurso que exponha dados de métricas no formato Prometheus. Para saber mais sobre o Prometheus, consulte a documentação oficial do Prometheus Conceitos Básicos.

Prometheus e Agentes de Gerenciamento

As etapas a seguir descrevem como coletar métricas do Prometheus com Agentes de Gerenciamento:

  • Etapa 1. Instalar o Management Agent com acesso ao ponto final de métricas do Prometheus.
  • Etapa 2. Ativar métricas do Prometheus
  • Etapa 3. Configurar uma origem de dados do Prometheus
  • Etapa 4. Criar um painel do Prometheus

    Etapa 1: Instalar o Management Agent

    Primeiro, você precisa instalar um Management Agent para registrar agentes no OCI (Oracle Cloud Infrastructure).
    Dependendo do seu ambiente, você pode selecionar uma das seguintes maneiras de instalar o Management Agent:
    • Instalar um Management Agent em uma instância do OCI.

      Se você tiver uma instância de computação do OCI, siga as instruções para ativar o Management Agent em uma instância de computação do OCI. Para obter informações sobre os pré-requisitos e o processo de instalação, consulte Implantar Management Agents em Instâncias do Serviço Compute.

    • Instale um Management Agent em uma instância que não seja do OCI.

      Se você tiver uma VM independente, precisará seguir as instruções para instalar um Agente de Gerenciamento em uma VM. Você deve instalar o Management Agent na mesma VM ou em uma VM com acesso ao ponto final do Prometheus. Para obter informações sobre os pré-requisitos e o processo de instalação, consulte Instalar Management Agents.

      Criar um grupo dinâmico e anexar uma política

      Em seguida, crie um grupo dinâmico do Management Agent com a política a seguir.
      1. Crie um grupo dinâmico para os Management Agents se ele ainda não existir. Por exemplo: Management-Agent-Dynamic-Group. Substitua o <AGENT_COMPARTMENT_OCID> pelo OCID do compartimento do Management Agent. 
        ALL {resource.type='managementagent' resource.compartment.id='<AGENT_COMPARTMENT_OCID>'}
      2. Anexe a política a seguir para permitir que o agente publique as métricas no namespace do OCI Monitoring. 
        allow dynamic-group Management-Agent-Dynamic-Group to use metrics in compartment <METRIC_COMPARTMENT_OCID> where target.metrics.namespace = '<OCI_MONITORING_NAMESPACE>'
      Observação

      Se quiser ver as métricas imediatamente, reinicie o Management Agent.
      Para obter mais informações sobre grupos dinâmicos, consulte Gerenciando Grupos Dinâmicos e Gerenciando Políticas.

      Etapa 2. Ativar métricas da Prometheus

      Para ativar as métricas do Prometheus para o software ou hardware, vá para as instruções oficiais do que você deseja monitorar para determinar qual método usar.

      Por exemplo, esta publicação no blog explica Como Configurar Contêineres do Docker no Oracle Cloud para usar métricas do Prometheus. Neste exemplo, as instruções do Docker no site oficial contêm as instruções mais recentes sobre como ativar o Prometheus em um contêiner do Docker.

      Etapa 3. Configurar uma origem de dados do Prometheus

      Em seguida, no Oracle Cloud, você pode configurar o Management Agent para coletar métricas do Prometheus adicionando e configurando uma origem de dados do Prometheus na Console do Oracle Cloud.

      Este vídeo demonstra como configurar uma origem de dados do Prometheus. Neste vídeo, uma fonte de dados Prometheus é configurada para um serviço Kafka. O processo para adicionar, editar e configurar uma origem de dados na console do Oracle Cloud é o mesmo para qualquer origem de dados que exponha métricas do Prometheus por meio de um URL.

      Para adicionar e configurar uma origem de dados do Prometheus:

      1. Na Console do Oracle Cloud, vá para o menu Navegação, selecione Observabilidade e Gerenciamento, vá para Agentes de Gerenciamento e selecione Agentes.
      2. Selecione Agentes e Gateways, selecione o Compartimento necessário e, em seguida, selecione o Agente.
      3. Selecione Gerenciar Origens de Dados e, em seguida, selecione Adicionar Origem de Dados.
      4. Selecione Prometheus na lista drop-down Tipo de Origem de Dados, adicione o Namespace de métricas, o URL e selecione o Compartimento de métricas. Se necessário, você pode adicionar Dimensões de métrica personalizadas ou definir quaisquer propriedades opcionais. Para obter uma lista de opções, consulte Propriedades de Origem de Dados Obrigatórias e Propriedades de Origem de Dados Opcionais.
        Observação

        Os valores de Namespace de métricas e Compartimento de métricas devem ser iguais aos valores da política.

      5. Clique em Adicionar.

        Agora, se configurado corretamente, após alguns minutos, as métricas serão exibidas no Serviço OCI Monitoring.

        Observação

        Se as políticas necessárias estiverem ausentes, você receberá mensagens de erro HTTP 404 NotAuthorized nos logs do Management Agent. Para obter mais detalhes, consulte Criar um grupo dinâmico e anexar uma política.

      Para exibir ou editar uma origem de dados do Prometheus:

      Depois de adicionar uma Origem de Dados, você pode ir para Gerenciar Origens de Dados e selecionar a elipse vertical ao lado da Origem de Dados que deseja exibir ou editar.

Propriedades da Origem de Dados Obrigatórias

As propriedades a seguir são obrigatórias quando você cria uma origem de dados Prometheus.

Nome Unidades/Formato Descrição
url String O url onde o Prometheus Exportador publica suas métricas. Suporta somente solicitações HTTP, por exemplo:

http://localhost:9100/metrics
namespace String O namespace do OCI Monitoring no qual as métricas raspadas são submetidas a upload.
compartmentId String O OCID do compartimento no qual as métricas raspadas são submetidas a upload.

Propriedades Opcionais da Origem de Dados

As propriedades a seguir são opcionais quando você cria uma origem de dados Prometheus. Para coletar uma faixa mais específica de métricas do Prometheus, você pode adicionar qualquer uma dessas propriedades opcionais ao criar a origem de dados.

Nome Unidades/Formato Descrição
allowMetrics String - lista de nomes de métricas separadas por vírgula O conjunto completo de métricas raspadas desejadas. Use esta propriedade para limitar o conjunto de métricas submetido a upload, se necessário.
connection-timeout Número em milissegundos O timeout para conexão com o ponto final do Prometheus Exportador.
metricDimensions String - lista de nomes de propriedades separadas por vírgula Os nomes de outras propriedades fornecidas pelo usuário expressos como valores fixos a serem usados como dimensões para cada ponto de dados carregado.
proxy-url String - URL O URL do proxy de rede que fornece acesso ao ponto final do Prometheus Exportador, propriedade de URL obrigatória.
limite de dados de leitura Número em kilobytes O limite dos dados que estão sendo enviados. Por exemplo, se 400 KB for inserido, o limite fixo do agente de gerenciamento não será excedido, 400 KB de espaço em disco.
tempo limite de leitura Número em milissegundos O tempo limite para ler a resposta do ponto final do Prometheus Exportador.
resourceGroup String. Inclui apenas caracteres alfanuméricos, pontos (.), sublinhados (_), hifens (-) e cifrões ($). O grupo de recursos do Serviço OCI Monitoring.

Se for especificado, o grupo de recursos será designado a cada uma das métricas emitidas.
scheduleMins Intervalo de raspagem em minutos Se esse valor for especificado, a coleta ou raspagem de dados ocorrerá nesse intervalo de tempo específico.

O valor mínimo é 1 minuto.

Se esse valor não for especificado, o valor padrão será 5 minutos.

Observação: A redução do intervalo de coleta pode ter um impacto positivo no desempenho da CPU.

Exemplo: scheduleMins=1

Criar um painel do Prometheus

Após a conclusão das etapas acima para configurar o Management Agent para exportar métricas do Prometheus, você poderá usar o serviço OCI Management Dashboards para criar um painel de controle e visualizar as métricas do Prometheus. Você pode configurar um widget do explorador de dados de métrica para cada métrica que deseja visualizar. Para obter informações, consulte Criar um Widget do Explorador de Dados de Métricas.