Plug-in do Grafana

Este tópico fornece instruções para instalar, configurar e usar o Oracle Cloud Infrastructure Data Source para Grafana.

Este tópico fornece instruções para instalar, configurar e usar o Oracle Cloud Infrastructure Data Source para Grafana, de outra forma referenciado como o Plug-in do Grafana.

Visão Geral do Plug-in do Grafana

O Grafana é uma visualização de código-fonte aberto e uma ferramenta de alerta que você pode usar para análise e monitoramento de dados de séries de tempo (métricas). Embora as métricas do serviço Oracle Cloud Infrastructure Monitoring estejam visíveis nos diagramas de métricas por meio da Console, você pode usar o Oracle Cloud Infrastructure Data Source for Grafana ("o Plug-in Grafana") para exibir métricas de recursos entre provedores em um único painel de controle do Grafana.

Pré-requisitos para Usar o Plug-in do Grafana

  • Uma conta no Oracle Cloud Infrastructure.
  • Um usuário nessa conta, em um grupo de segurança com uma política do IAM que concede as permissões necessárias para trabalhar com recursos nos compartimentos da conta. A política deve conceder a você acesso aos namespaces de métrica que emitem métricas (como o serviço Compute), bem como aos recursos relacionados (como um conjunto de instâncias de computação). Se você tentar executar uma ação e receber uma mensagem de que não tem permissão ou que não tem autorização, confirme com o administrador o tipo de acesso concedido e em qual compartimento você deve trabalhar, Administradores: Para políticas comuns que dão aos grupos acesso a métricas, consulte Acesso a Métricas para Grupos. Para autorizar recursos, como instâncias, a fazer chamadas da API, adicione os recursos a um grupo dinâmico por meio de regras de correspondência e crie uma política que permita ao grupo dinâmico acessar as métricas. Para permitir o acesso entre compartimentos, crie a política na tenancy. Por causa do conceito de herança de política, as instâncias do grupo dinâmico indicado podem acessar métricas em qualquer compartimento. Para reduzir o escopo de acesso a um compartimento em particular, especifique esse compartimento em vez da tenancy. Consulte Acesso a Métricas para Recursos.
  • Instâncias do serviço Compute: Para emitir métricas, o plug-in de Monitoramento da Instância do serviço Compute deve estar ativado na instância e plug-ins devem estar em execução. A instância também deve ter um gateway de serviço ou um endereço IP público para enviar métricas ao serviço Monitoring. Para obter mais informações, consulte Ativando o Monitoramento de Instâncias do Compute.
  • Chaves necessárias e IDs do Oracle Cloud Infrastructure (OCIDs). Para obter orientação, consulte Chaves e OCIDs Necessários.

Download e Instalação do Plug-in do Grafana

Observação

O Grafana deve ser instalado para que você possa instalar o Plug-in do Grafana. Versão 3.0 ou posterior obrigatória.

A autenticação para acesso a métricas depende de onde o Grafana está sendo executado. Se você estiver executando o Grafana em uma máquina local fora da Oracle Cloud Infrastructure, deverá chamar a API de Monitoramento usando a CLI (Command Line Interface). Se você estiver executando Grafana em uma instância de computação da Oracle Cloud Infrastructure que criou, poderá adicionar a instância a um grupo dinâmico configurando uma regra de correspondência. Em todos os cenários, você tem a opção de chamar a API usando a CLI.

Para obter instruções sobre como instalar o Plug-in do Grafana (Origem de Dados do Oracle Cloud Infrastructure para Grafana), consulte https://github.com/oracle/oci-grafana-plugin.

Configurar o Plug-in do Grafana

Esta seção descreve como adicionar o Plug-in do Grafana e configurar um dashboard.

Para configurar o Plug-in do Grafana
Observação

Quando instalado localmente, o plug-in do Grafana acessa métricas usando chamadas à API do Monitoring.
  1. Configure a CLI para acessar APIs da Oracle Cloud Infrastructure.

    Você precisará acessar a API de Monitoramento para autenticação.

  2. Navegue até a homepage do Grafana no URL a seguir.

    http://localhost:3000

  3. Adicione o plug-in do Grafana (origem de dados do Oracle Cloud Infrastructure para Grafana).

    Além das etapas abaixo, consulte as instruções do Grafana para adicionar origens de dados em https://grafana.com/docs/grafana/latest/getting-started/getting-started/.

    1. No Grafana, no Dashboard Inicial, clique no ícone de engrenagem à esquerda.
    2. Clique em Adicionar origem de dados.
    3. Na caixa de texto Filtro, digite: oracle-oci-datasource
    4. Na lista filtrada, selecione oracle-oci-datasource.
    5. Na página Definições, preencha o OCID da sua Tenancy, a Região Padrão e o Ambiente. Para Ambiente, escolha local.

  4. Configure um dashboard do tipo "Gráfico".
  5. (Opcional) Para confirmar o acesso a métricas do Oracle Cloud Infrastructure, atualize sua consulta de painel de controle ("Métricas") com uma região, compartimento, namespace, métrica específicos. Você também pode adicionar uma ou mais dimensões.

    Parabéns. Agora você pode ver suas métricas da Oracle Cloud Infrastructure na Grafana!

Opções de ambiente

local se destina a implantações do Grafana fora da Oracle Cloud Infrastructure.

A Instância da OCI é para implantações do Grafana em recursos da Oracle Cloud Infrastructure.

A origem de dados agora foi adicionada, permitindo que você configure um painel de controle mostrando métricas do Oracle Cloud Infrastructure.

Diagnosticar e Solucionar Problemas do Plug-in

Se a consulta do painel de instrumentos ("Métricas") não for preenchida com opções, ou se você tiver outros problemas ao acessar métricas, a política do IAM usada para acessar métricas poderá estar malformada ou poderá não incluir todas as regras de correspondência necessárias para seu grupo dinâmico (para executar Grafana em uma instância de computação da Oracle Cloud Infrastructure que você criou).

Para resolver esse problema, faça o seguinte:

  • Verifique sua política do IAM para garantir que ela corresponda aos pré-requisitos.
  • Se você tiver atualizado sua política do IAM, reinicie o servidor Grafana e atualize a home page do Grafana.