Ativando o Monitoramento de Instâncias do Serviço Compute

Este tópico descreve como ativar o monitoramento, especificamente para as métricas da instância de computação, em instâncias de computação.

As métricas da instância de computação fornecem dados sobre o nível de atividade e o throughput da instância. Essas métricas são obrigatórias para usar recursos como dimensionamento automático, métricas, alarmes e notificações com instâncias de computação. Uma instância de computação só emite essas métricas quando o plug-in Compute Instance Monitoring está ativado e em execução na instância.

O plug-in Compute Instance Monitoring é gerenciado pelo software Oracle Cloud Agent.

Imagens Suportadas

Há suporte para métricas de instâncias de computação nas imagens da plataforma atual e nas imagens personalizadas baseadas nas imagens da plataforma atual.

Se você usar uma imagem de plataforma mais antiga, instale manualmente o software Oracle Cloud Agentpara poder usar o plug-in Compute Instance Monitoring. Selecione uma imagem com data posterior a 15 de novembro de 2018 (exceto Ubuntu, que deve ter data posterior a 28 de fevereiro de 2019).

Você pode ter sucesso ao ativar métricas da instância de computação em outras imagens que suportam o software Oracle Cloud Agent, embora o plug-in Compute Instance Monitoring não tenha sido testado em outros sistemas operacionais e não haja garantia de que ele funcione.

Política de IAM Necessária

Para usar o Oracle Cloud Infrastructure, você deve receber de um administrador o acesso de segurança em uma política . Esse acesso é necessário, quer você esteja usando a Console ou a API REST com um SDK, uma CLI ou outra ferramenta. Caso receba uma mensagem de que você não tem permissão ou não está autorizado, verifique com o administrador o tipo de acesso que você tem e em qual compartimento  trabalhar.

Para administradores: Para obter mais informações sobre as políticas do IAM necessárias para criar e atualizar uma instância de computação, consulte Criando uma Instância.

Antes de começar

  • Gateways de serviço ou endereços IP públicos: A instância de computação deve ter um endereço IP público ou um gateway de serviço para poder enviar métricas da instância de computação ao serviço Monitoring.

    Se a instância não tiver um endereço IP público, configure um gateway de serviço na rede virtual na nuvem (VCN). O gateway de serviço permite que a instância de computação envie métricas para o serviço Monitoring sem o tráfego que transita pela internet. Aqui estão observações especiais para configurar o gateway de serviço para acessar o serviço Monitoring:

    • Ao criar o gateway de serviço, ative o label de serviço chamado Todos os Serviços <region> no Oracle Services Network. Ele inclui o serviço Monitoring.
    • Ao configurar o roteamento da sub-rede que contém a instância, configure uma regra de roteamento com o Tipo de Destino definido como Gateway de Serviço e o Serviço de Destino definido como Todos os Serviços <region> no Oracle Services Network.

    Para ver instruções, consulte Acesso a Serviços Oracle: Gateway de Serviço.

  • Oracle Cloud Agent: O software Oracle Cloud Agent deve ser instalado na instância. O Oracle Cloud Agent é instalado por padrão nas imagens da plataforma atual. Para obter as etapas de instalação manual do Oracle Cloud Agent em imagens mais antigas, consulte Instalando o Software Oracle Cloud Agent.
  • Plug-in Compute Instance Monitoring: Para que a instância emita as métricas da instância de computação, o plug-in Compute Instance Monitoring deve estar ativado na instância e os plug-ins devem estar em execução. Para obter mais informações sobre como ativar e executar plug-ins, consulte Oracle Cloud Agent.

Ativando o Monitoramento de uma Nova Instância do Serviço Compute

Para configurar uma nova instância de computação para emitir métricas, use as etapas a seguir.

Criando uma Instância Ativada para Monitoramento Usando a Console

  1. Siga as etapas para criar uma instância, até as opções avançadas. Certifique-se de que a instância tenha um endereço IP público ou um gateway de serviço, conforme descrito nos pré-requisitos.
  2. Clique em Mostrar Opções Avançadas.
  3. Na guia Oracle Cloud Agent, selecione Compute Instance Monitoring.

    Observação

    Se você estiver usando uma imagem de plataforma mais antiga ou uma imagem personalizada que não seja baseada em uma imagem de plataforma recente, instale manualmente o software Oracle Cloud Agent. Você pode fazer isso fornecendo um script cloud-init. Para obter mais informações, consulte Instalando o Software Oracle Cloud Agent. Compare a data da imagem com a data listada em Imagens Suportadas.
  4. Clique em Criar.

    A instância recém-criada ativada para monitoramento emite métricas da instância de computação para o serviço Monitoring.

Criando uma Instância Ativada para Monitoramento Usando a API

Use a operação LaunchInstance. Inclua os seguintes parâmetros:

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Certifique-se de que a instância tenha um endereço IP público ou um gateway de serviço, conforme descrito nos pré-requisitos.

Observação

Se você estiver usando uma imagem de plataforma mais antiga ou uma imagem personalizada que não seja baseada em uma imagem de plataforma recente, instale manualmente o software Oracle Cloud Agent. Você pode fazer isso fornecendo um script cloud-init. Para obter mais informações, consulte Instalando o Software Oracle Cloud Agent. Compare a data da imagem com a data listada em Imagens Suportadas.

Ativando o Monitoramento de uma Instância do Serviço Compute Existente

Para configurar uma instância de computação existente para emitir as métricas da instância de computação, use as etapas a seguir.
Para ativar o monitoramento em uma instância de computação existente usando a Console
  1. Instale o software Oracle Cloud Agent, se ele ainda não estiver instalado.
  2. Ative o plug-in Compute Instance Monitoring.
  3. Confirme se os plug-ins estão em execução na instância.
  4. Certifique-se de que a instância tenha um endereço IP público ou um gateway de serviço, conforme descrito nos pré-requisitos.
  5. Para confirmar se o monitoramento está ativado:

    1. Vá para a página Métricas da instância:
      1. Abra o menu de navegação e clique em Compute. No serviço Compute, clique em Instâncias.
      2. Clique na instância em que você está interessado.
      3. Em Recursos, clique em Métricas.
      4. Na lista Namespace de métricas, selecione oci_computeagent.
    2. Caso você veja gráficos de métricas com dados, é porque o serviço Monitoring está recebendo métricas dessa instância. Para obter mais informações sobre essas métricas, consulte Métricas da Instância do Serviço Compute.

      Se o monitoramento não estiver ativado (e a instância usar uma imagem suportada), um botão estará disponível para ativar o monitoramento. Clique em Ativar monitoramento.

Para ativar o monitoramento em uma instância de computação existente usando a API
  1. Instale o software Oracle Cloud Agent, se ele ainda não estiver instalado.
  2. Use a operaçãoUpdateInstance. Inclua os seguintes parâmetros:

    {
      "agentConfig": {
        "isMonitoringDisabled": false,
        "areAllPluginsDisabled": false,
        "pluginsConfig": [
          {
            "name": "Compute Instance Monitoring",
            "desiredState": "ENABLED"
          }
        ]
      }
    }
  3. Certifique-se de que a instância tenha um endereço IP público ou um gateway de serviço, conforme descrito nos pré-requisitos.

Gerenciando o Plug-in Compute Instance Monitoring

Para que uma instância emita métricas de computação, o plug-in Compute Instance Monitoring deve estar ativado na instância e os plug-ins devem estar em execução.

Para impedir temporariamente que a instância emita métricas de computação, você poderá desativar o plug-in Compute Instance Monitoring. Você também pode interromper todos os plug-ins executados na instância, incluindo o plug-in Compute Instance Monitoring.

Cuidado

A funcionalidade que depende do plug-in, como monitoramento e dimensionamento automático, não funciona quando o plug-in está desativado ou foi interrompido.

Para obter mais informações sobre como ativar e executar plug-ins, consulte Oracle Cloud Agent.

Diagnóstico e Solução de Problemas: Descobrindo se o Serviço Monitoring Tem Métricas

Para determinar se o serviço Monitoring está recebendo métricas da instância de computação, você pode consultar as métricas da instância ou exibir as propriedades da instância para confirmar se o plug-in Compute Instance Monitoring está ativado e em execução.

Usando a Console: Para descobrir se o serviço Monitoring está recebendo métricas consultando as métricas da instância
  1. Abra o menu de navegação e clique em Compute. No serviço Compute, clique em Instâncias.
  2. Clique na instância em que você está interessado.
  3. Em Recursos, clique em Métricas.
  4. Na lista Namespace de métricas, selecione oci_computeagent.

    Se você vir gráficos de métricas com dados, é porque o serviço Monitoring está recebendo métricas dessa instância. Para obter mais informações sobre essas métricas, consulte Métricas da Instância do Serviço Compute.

    Se você vir uma mensagem que o monitoramento não está ativado ou que o software Oracle Cloud Agent precisa ser instalado, conclua essas tarefas.

Usando a Console: Para descobrir se o plug-in Compute Instance Monitoring está ativado e em execução
  1. Abra o menu de navegação e clique em Compute. No serviço Compute, clique em Instâncias.
  2. Clique na instância em que você está interessado.
  3. Clique na guia Oracle Cloud Agent.
  4. Confirme se o plug-in Compute Instance Monitoring está ativado e se todos os plug-ins estão em execução.
Usando a API: Para descobrir se o serviço Monitoring está recebendo métricas consultando as métricas da instância

Use a operação SummarizeMetricsData da API. Se métricas forem retornadas, isso indicará que o serviço Monitoring está recebendo métricas da instância.

Usando a API: Para descobrir se o plug-in Compute Instance Monitoring está ativado e em execução

Use a operação GetInstance (ou a operação ListInstances, para várias instâncias).

Na resposta, se o objeto agentConfig retornar os valores a seguir, isso indicará que o plug-in Compute Instance Monitoring está ativado e todos os plug-ins estão em execução.
{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}
Não está vendo as métricas da sua instância?

Se você não vir gráficos de métricas, pode ser que a instância não esteja emitindo métricas. Consulte as possíveis causas e soluções a seguir.

Possível causa Como verificar Solução
O plug-in Compute Instance Monitoring está desativado na instância ou os plug-ins foram interrompidos. Verifique as propriedades da instância. Ative o plug-in Compute Instance Monitoring e inicie todos os plug-ins.
A instância não pode acessar o serviço Monitoring porque sua VCN não usa a internet. Verifique o endereço IP da instância. Caso não seja público, será necessário um gateway de serviço. Configure um gateway de serviço.
A instância não usa uma imagem suportada. Verifique as imagens suportadas. Crie uma instância com uma imagem suportada.
Imagens mais antigas e imagens personalizadas: Não existe software Oracle Cloud Agent na instância. Conecte-se à instância e procure o software. Instale o software Oracle Cloud Agent.
Outra coisa está errada com o software Oracle Cloud Agent. (não aplicável) Siga as etapas de solução de problemas do Oracle Cloud Agent.