Implantar recursos de observabilidade e configurar logs

A observabilidade das Operações do Azure IoT oferece visibilidade em todas as camadas da configuração e fornece insights sobre o comportamento real dos problemas, o que aumenta a eficácia da engenharia de confiabilidade de sites. As Operações do Azure IoT oferecem observabilidade por meio de painéis do Grafana personalizados e coletados, hospedados no Azure, da plataforma do serviço gerenciado do Azure Monitor para Prometheus e do Container Insights.

Este artigo mostra como implantar recursos de observabilidade das Operações do Azure IoT, configurar o Prometheus e o Grafana gerenciados pelo Azure e habilitar o monitoramento abrangente para o cluster do Azure Arc.

Pré-requisitos

Um cluster do Kubernetes habilitado para Arc.
CLI do Azure instalada em seu computador de cluster. Para obter as instruções, confira Como instalar a CLI do Azure.
Helm instalado em seu computador de cluster. Para obter instruções, consulte Instalar o Helm.
Kubectl instalado em seu computador de cluster. Para obter instruções, consulte Instalar ferramentas do Kubernetes.

Criar recursos no Azure

Registre provedores com a assinatura em que o cluster está localizado.

Observação

Execute essa etapa apenas uma vez por assinatura. Para registrar provedores de recursos, você precisa de permissão para executar a /register/action operação, que está incluída nas funções Colaborador e Proprietário da assinatura. Para saber mais, veja Provedores e tipos de recursos do Azure.
```
az account set -s <SUBSCRIPTION_ID>
az provider register --namespace Microsoft.AlertsManagement
az provider register --namespace Microsoft.Monitor
az provider register --namespace Microsoft.Dashboard
az provider register --namespace Microsoft.Insights
az provider register --namespace Microsoft.OperationalInsights
```
Instale as extensões da CLI do Azure para coleta de Métricas para clusters habilitados para Azure Arc e Espaço Gerenciado do Azure para Grafana:
```
az extension add --upgrade --name k8s-extension
az extension add --upgrade --name amg
```
Crie um workspace do Azure Monitor para habilitar a coleta de métricas para o cluster Kubernetes habilitado com o Azure Arc.
```
az monitor account create --name <WORKSPACE_NAME> --resource-group <RESOURCE_GROUP> --location <LOCATION> --query id -o tsv
```
Salve a ID do workspace do Azure Monitor na saída desse comando. Use a ID ao habilitar a coleta de métricas na próxima seção.
Crie uma instância do Espaço Gerenciado do Azure para Grafana para visualizar suas métricas do Prometheus:
```
az grafana create --name <GRAFANA_NAME> --resource-group <RESOURCE_GROUP> --query id -o tsv
```
Salve a ID do Grafana da saída deste comando. Use a ID ao habilitar a coleta de métricas na próxima seção.
Crie um workspace do Log Analytics para o Container Insights:
```
az monitor log-analytics workspace create -g <RESOURCE_GROUP> -n <LOGS_WORKSPACE_NAME> --query id -o tsv
```
Salve a ID do workspace do Log Analytics na saída desse comando. Use a ID ao habilitar a coleta de métricas na próxima seção.

Habilitar a coleta de métricas para o cluster

Atualize o cluster do Azure Arc para coletar métricas e enviá-las para o workspace do Azure Monitor que você criou. Você também vincula esse workspace à instância do Grafana:

az k8s-extension create --name azuremonitor-metrics --cluster-name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers.Metrics --configuration-settings azure-monitor-workspace-resource-id=<AZURE_MONITOR_WORKSPACE_ID> grafana-resource-id=<GRAFANA_ID>

Habilitar logs do Container Insights para coleta de logs:

az k8s-extension create --name azuremonitor-containers --cluster-name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings logAnalyticsWorkspaceResourceID=<LOG_ANALYTICS_WORKSPACE_ID>

Após concluir essas etapas, o Azure Monitor e o Grafana estarão configurados e vinculados ao cluster para observabilidade e coleta de métricas.

Implantar o coletor do OpenTelemetry

Defina e implante um Coletor OTel (OpenTelemetry) no cluster Kubernetes habilitado para Arc.

Crie um arquivo chamado otel-collector-values.yaml e cole o seguinte código nele para definir um coletor do OpenTelemetry:

mode: deployment
fullnameOverride: aio-otel-collector
image:
  repository: otel/opentelemetry-collector
  tag: 0.107.0

config:
  processors:
    memory_limiter:
      limit_percentage: 80
      spike_limit_percentage: 10
      check_interval: 60s

  receivers:
    otlp:
      protocols:
        grpc:
          endpoint: ":4317"
        http:
          endpoint: ":4318"

  exporters:
    prometheus:
      endpoint: ":8889"
      resource_to_telemetry_conversion:
        enabled: true
      add_metric_suffixes: false

  service:
    extensions:
      - health_check

    telemetry:
      metrics:
        readers: []

    pipelines:
      metrics:
        receivers:
          - otlp
        exporters:
          - prometheus

resources:
  limits:
    cpu: "100m"
    memory: "512Mi"

ports:
  metrics:
    enabled: true
    containerPort: 8889
    servicePort: 8889
    protocol: TCP

No arquivo otel-collector-values.yaml, anote os seguintes valores que você usa no comando az iot ops create ao implantar as Operações do Azure IoT no cluster:
- fullnameOverride
- grpc.endpoint
- check_interval
Salve e feche o arquivo.

Implante o coletor executando os seguintes comandos:

kubectl get namespace azure-iot-operations || kubectl create namespace azure-iot-operations
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts

helm repo update
helm upgrade --install aio-observability open-telemetry/opentelemetry-collector -f otel-collector-values.yaml --namespace azure-iot-operations

Configurar a coleção de métricas do Prometheus

Configure a coleta de métricas do Prometheus em seu cluster.

Crie um arquivo chamado ama-metrics-prometheus-config.yaml e cole a seguinte configuração:

apiVersion: v1
data:
  prometheus-config: |2-
    scrape_configs:
      - job_name: otel
        scrape_interval: 1m
        static_configs:
          - targets:
            - aio-otel-collector.azure-iot-operations.svc.cluster.local:8889
      - job_name: aio-annotated-pod-metrics
        kubernetes_sd_configs:
          - role: pod
        relabel_configs:
          - action: drop
            regex: true
            source_labels:
              - __meta_kubernetes_pod_container_init
          - action: keep
            regex: true
            source_labels:
              - __meta_kubernetes_pod_annotation_prometheus_io_scrape
          - action: replace
            regex: ([^:]+)(?::\\d+)?;(\\d+)
            replacement: $1:$2
            source_labels:
              - __address__
              - __meta_kubernetes_pod_annotation_prometheus_io_port
            target_label: __address__
          - action: replace
            source_labels:
              - __meta_kubernetes_namespace
            target_label: kubernetes_namespace
          - action: keep
            regex: 'azure-iot-operations'
            source_labels:
              - kubernetes_namespace
        scrape_interval: 1m
kind: ConfigMap
metadata:
  name: ama-metrics-prometheus-config
  namespace: kube-system

Aplique o arquivo de configuração executando o seguinte comando:
```
kubectl apply -f ama-metrics-prometheus-config.yaml
```

Configurar a configuração de observabilidade

Você pode definir a configuração de observabilidade da implantação das Operações do Azure IoT a qualquer momento. Depois que os recursos de observabilidade forem configurados, você poderá atualizar a configuração de observabilidade executando o az iot ops upgrade comando com o --ops-config parâmetro para especificar os novos valores de configuração:

az iot ops upgrade --resource-group <rg name> -n <instance name> --ops-config observability.metrics.openTelemetryCollectorAddress=<>

Parâmetro	Valor	Descrição
`--ops-config`	`observability.metrics.openTelemetryCollectorAddress=<FULLNAMEOVERRIDE>.azure-iot-operations.svc.cluster.local:<GRPC_ENDPOINT>`	Forneça o endereço do coletor OpenTelemetry (OTel) configurado no arquivo otel-collector-values.yaml. As instruções neste artigo usam os valores `fullnameOverride=aio-otel-collector` de exemplo e `grpc.endpoint=4317`.
`--ops-config`	`observability.metrics.exportInternalSeconds=<CHECK_INTERVAL>`	Forneça o valor `check_interval` que você configurou no arquivo otel-collector-values.yaml. As instruções neste artigo usam o valor de exemplo `check_interval=60`.

Observação

Em versões de visualização, o comando az iot ops upgrade não funciona para atualização para uma versão de visualização, mas funciona para configurar as Operações do Azure IoT para observabilidade.

Implantar painéis no Grafana

As Operações do Azure IoT fornecem um painel de exemplo projetado para fornecer muitas das visualizações necessárias para entender a integridade e o desempenho da implantação das Operações do Azure IoT.

Conclua as seguintes etapas para instalar os painéis do Grafana curados do Azure IoT Operations:

Clone ou baixe o repositório azure-iot-operations para obter o arquivo JSON do Painel do Grafana de exemplo localmente: https://github.com/Azure/azure-iot-operations.
Entre no console do Grafana. Você pode acessar o console por meio do portal do Azure ou usar o comando az grafana show para recuperar a URL.
```
az grafana show --name <GRAFANA_NAME> --resource-group <RESOURCE_GROUP> --query url -o tsv
```
Na página de aterrissagem do Grafana, selecione o bloco Crie seu primeiro painel.
Selecione Importar Painel.
Navegue até o diretório de amostra de painéis na cópia local do repositório das Operações do Azure IoT, azure-iot-operations > samples > grafana-dashboard, e selecione o arquivo de painel aio.sample.json.
Quando o aplicativo for solicitado, selecione a fonte de dados do Prometheus Gerenciado.
Selecione Importar.

Próximas etapas

Como limpar os recursos de observabilidade

Comentários

Esta página foi útil?

Last updated on 2025-12-19