O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Criar painéis de visualização

Os painéis do Grafana permitem visualizar registros e métricas no Google Distributed Cloud (GDC) com isolamento físico. Esses painéis oferecem visualizações dinâmicas da integridade e do desempenho do sistema por meio de painéis personalizáveis.

Um painel fornece uma representação visual dinâmica do desempenho do seu sistema. Ele consiste em um ou mais painéis personalizáveis, cada um configurado para consultar e exibir métricas específicas dos componentes do GDC. Com esses painéis, é possível:

Visualize métricas em vários tipos de gráficos.
Defina limites de alerta para acionar notificações com base em valores de métricas.
Personalize as propriedades de exibição, como rótulos, unidades e períodos.
Defina resoluções de tempo consistentes para comparações precisas.

Ao usar os painéis do Grafana de maneira eficaz, você pode receber insights valiosos sobre o desempenho e a integridade do seu ambiente do GDC.

Antes de começar

Para gerenciar os recursos personalizados Dashboard e ConfigMap, é preciso ter as permissões necessárias.

Solicitar papéis da organização do IAM

Entre em contato com o admin. da organização do IAM para solicitar os seguintes papéis para trabalhar com painéis em uma organização:

Criador de PA do painel (dashboard-pa-creator): cria painéis personalizados.
Editor de PA do painel (dashboard-pa-editor): editar ou excluir painéis personalizados.
Leitor de PA do painel (dashboard-pa-viewer): visualizar painéis personalizados.

Solicitar papéis do IAM para o projeto

Entre em contato com o administrador do projeto do IAM para solicitar os seguintes papéis para trabalhar com painéis e configurações em um projeto:

Editor de painéis (dashboard-editor): criar, editar e excluir painéis personalizados no namespace do projeto.
Leitor de painéis (dashboard-viewer): visualizar painéis personalizados no namespace do projeto.
Editor do ConfigMap (observabilitypipeline-configmap-editor): criar e editar um ConfigMap no namespace do projeto.

Preparar o ambiente

Depois de receber os papéis correspondentes, siga estas etapas antes de criar painéis:

Coletar métricas das cargas de trabalho.
Defina o caminho do arquivo kubeconfig como uma variável de ambiente:
```
export KUBECONFIG=KUBECONFIG_PATH
```
Substitua KUBECONFIG_PATH pelo caminho para o arquivo kubeconfig do servidor de API de gerenciamento em que você quer criar o painel.

Identificar o endpoint do Grafana

O URL a seguir é o endpoint da instância do Grafana do seu projeto:

https://GDC_URL/PROJECT_NAMESPACE/grafana

Substitua:

GDC_URL: o URL da sua organização no GDC.
PROJECT_NAMESPACE: o namespace do projeto.

Por exemplo, o endpoint do Grafana para o projeto platform-obs na organização org-1 é https://org-1/platform-obs/grafana.

Criar um painel personalizado

Siga estas etapas para criar um painel do Grafana e personalizar suas configurações:

Abra o endpoint do Grafana para exibir a interface do usuário.
No menu de navegação, clique em Adicionar.
No menu suspenso, clique em Painel. O Grafana cria um painel vazio.
No painel vazio, adicione todos os painéis que quiser.
No menu Fonte de dados de cada painel, selecione a fonte de dados que você quer para o painel, incluindo métricas (prometheus), registros de auditoria (auditloki) e registros operacionais (oploki).

Para universos de várias zonas, o Grafana tem fontes de dados rotuladas por zona que podem ser usadas para criar visualizações de painel com métricas e registros de várias zonas. Essas fontes de dados são nomeadas com o formato DATA_SOURCE-ZONE_ID, em que:
- DATA_SOURCE pode usar um dos seguintes valores:
  - Prometheus (prometheus ou metrics) para exibir métricas.
  - Registros de auditoria (auditloki) para exibir registros de auditoria.
  - Registros operacionais (oploki) para exibir registros operacionais.
- ZONE_ID é o ID da zona em que você quer exibir dados no painel.
Além disso, para criar um painel de visualização para recursos entre zonas, o nome da fonte de dados é --Mixed--. Essa fonte de dados permite adicionar várias consultas por zona e ter visualizações de dados entre zonas em um único painel. É possível usar esse recurso para fazer comparações de comportamento entre, por exemplo, uma única métrica ou consulta de registro em várias zonas do seu universo.
Personalize os detalhes e edite os painéis para fornecer as consultas ou fazer outras atualizações.

Dica :ao personalizar o painel, implemente as práticas recomendadas para seu caso de uso para facilitar a visualização e a interpretação dos dados de observabilidade dos componentes. Por exemplo, estabeleça limites de aceitação, exiba indicadores úteis, adicione rótulos aos gráficos e escolha uma resolução de tempo consistente.
Na barra de menus, clique em Configurações do painel para abrir a página Configurações.
No menu de navegação, selecione Modelo JSON.
Copie o modelo JSON do painel e cole-o em um arquivo de texto simples para uso futuro.

Criar um objeto `ConfigMap`.

Siga estas etapas para criar um objeto ConfigMap que contenha o modelo JSON do painel:

Abra uma janela do terminal.
Criar um objeto ConfigMap. Na seção data do objeto ConfigMap, cole o modelo JSON que você copiou anteriormente:
```
apiVersion: v1
kind: ConfigMap
metadata:
  namespace: PROJECT_NAMESPACE
  name: CONFIGMAP_NAME
data:
  JSON_FILE_NAME.json: |
    {
    JSON_MODEL
    }
```
Substitua:
- PROJECT_NAMESPACE: o namespace do projeto.
- CONFIGMAP_NAME: o nome que você quer dar ao objeto ConfigMap.
- JSON_FILE_NAME: o nome que você quer dar ao arquivo do modelo JSON do painel.
- JSON_MODEL: o modelo JSON do seu painel personalizado.
Para ver um exemplo de como esse objeto precisa ser, consulte um exemplo de ConfigMap.

Aplique o objeto ConfigMap ao servidor de API Management:

kubectl --kubeconfig ${KUBECONFIG} apply -f CONFIGMAP_NAME.yaml

Exemplo de `ConfigMap`

O arquivo YAML a seguir mostra um exemplo do objeto ConfigMap de um painel no namespace platform-obs:

  apiVersion: v1
  kind: ConfigMap
  metadata:
    namespace: platform-obs
    name: my-project-dashboard-configmap
  data:
    my-project-dashboard.json: |
      {
      "annotations": {
        "list": [
          {
            "builtIn": 1,
            "datasource": "--",
            "enable": true,
            "hide": true,
            "iconColor": "rgba(0, 211, 255, 1)",
            "name": "Annotations & Alerts",
            "type": "dashboard"
          }
        ]
      },
      "editable": true,
      "graphTooltip": 0,
      "id": null,
      "links": [],
      "panels": [],
      "schemaVersion": 27,
      "style": "dark",
      "tags": [],
      "templating": {
        "list": []
      },
      "time": {
        "from": "now-6h",
        "to": "now"
      },
      "timepicker": {},
      "timezone": "",
      "title": "Sample dashboard",
      "uid": null,
      "version": 0
      }

Criar um recurso personalizado `Dashboard`

Siga estas etapas para criar um recurso personalizado Dashboard e importar o painel personalizado para a instância do Grafana do seu projeto:

Abra uma janela do terminal.
Crie um recurso personalizado Dashboard e configure o arquivo com o nome que você deu ao objeto ConfigMap:
```
apiVersion: observability.gdc.goog/v1
kind: Dashboard
metadata:
  namespace: PROJECT_NAMESPACE
  name: DASHBOARD_NAME
spec:
  configMapRef:
    name: CONFIGMAP_NAME
    namespace: PROJECT_NAMESPACE
    key: JSON_FILE_NAME.json
  foldername: Default
```
Substitua:
- PROJECT_NAMESPACE: o namespace do projeto.
- DASHBOARD_NAME: o nome que você quer dar ao recurso personalizado Dashboard.
- CONFIGMAP_NAME: o nome que você deu ao objeto ConfigMap.
- JSON_FILE_NAME: o nome que você deu ao arquivo que contém o modelo JSON do painel no objeto ConfigMap.
Observação :para organizar painéis em pastas, especifique o foldername na seção spec do recurso Dashboard. Se você omitir esse campo, o padrão será a pasta Default. As pastas serão criadas automaticamente se não existirem.

Aplique o recurso personalizado Dashboard ao servidor de API Management:

kubectl --kubeconfig ${KUBECONFIG} apply -f DASHBOARD_NAME.yaml

O sistema monitora as mudanças no recurso personalizado Dashboard e no objeto ConfigMap associado. Para atualizar ou excluir um painel, modifique esses recursos. Qualquer modificação aciona uma atualização do Grafana. Não é possível salvar as atualizações feitas diretamente na interface do usuário do Grafana.