Implante gateway auto-hospedado no Kubernetes com integração OpenTelemetry

Artigo
04/04/2024

APLICA-SE A: Developer | Prémio

Este artigo descreve as etapas para implantar o componente de gateway auto-hospedado do Gerenciamento de API do Azure em um cluster Kubernetes e enviar automaticamente todas as métricas para um Coletor OpenTelemetry .

Importante

O suporte do OpenTelemetry para o gateway auto-hospedado do Azure API Management está atualmente em visualização e requer 2.0.0 tag ou superior.

Sabe como:

Configurar e implantar um coletor OpenTelemetry autônomo no Kubernetes
Implante o gateway auto-hospedado com métricas OpenTelemetry .
Gere métricas consumindo APIs no gateway auto-hospedado.
Use as métricas do OpenTelemetry Collector.

Pré-requisitos

crie uma instância da Gestão de API do Azure
Crie um cluster do Azure Kubernetes usando a CLI do Azure, usando o Azure PowerShell ou usando o portal do Azure.
Provisione um recurso de gateway auto-hospedado em sua instância de Gerenciamento de API.

Introdução ao OpenTelemetry

OpenTelemetry é um conjunto de ferramentas e estruturas de código aberto para registro, métricas e rastreamento de forma neutra do fornecedor.

Importante

O suporte do OpenTelemetry para o gateway auto-hospedado do Azure API Management está atualmente em visualização e requer 2.0.0 tag ou superior.

O gateway auto-hospedado pode ser configurado para coletar e enviar métricas automaticamente para um OpenTelemetry Collector. Isso permite que você traga sua própria solução de coleta de métricas e relatórios para o gateway auto-hospedado.

Nota

OpenTelemetry é um projeto incubador do ecossistema Cloud Native Computing Foundation (CNCF).

Métricas

O gateway auto-hospedado começará automaticamente a medir as seguintes métricas:

Pedidos do
DuraçãoInMs
BackendDurationInMs
ClientDurationInMs
GatewayDurationInMs

Eles são exportados automaticamente para o OpenTelemetry Collector configurado a cada 1 minuto com dimensões adicionais.

Implantar o OpenTelemetry Collector

Começaremos implantando um OpenTelemetry Collector autônomo no Kubernetes usando o Helm.

Gorjeta

Embora estejamos usando o gráfico Collector Helm, eles também fornecem um OpenTelemetry Collector Operator

Para começar, temos que adicionar o repositório de gráficos Helm:

Adicionar o repositório Helm

helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts

Atualize o repositório para buscar os gráficos Helm mais recentes.
```
helm repo update
```

Verifique a configuração do Helm listando todos os gráficos disponíveis.

$ helm search repo open-telemetry
NAME                                    CHART VERSION   APP VERSION     DESCRIPTION
open-telemetry/opentelemetry-collector  0.8.1           0.37.1          OpenTelemetry Collector Helm chart for Kubernetes
open-telemetry/opentelemetry-operator   0.4.0           0.37.0          OpenTelemetry Operator Helm chart for Kubernetes

Agora que temos o repositório de gráficos configurado, podemos implantar o OpenTelemetry Collector em nosso cluster:

Crie um arquivo de configuração local chamado opentelemetry-collector-config.yml com a seguinte configuração:

mode: deployment
config:
  exporters:
    prometheus:
      endpoint: "0.0.0.0:8889"
      namespace: azure_apim
      send_timestamps: true
  service:
    pipelines:
      metrics:
        exporters:
        - prometheus
service:
  type: LoadBalancer
ports:
  jaeger-compact:
    enabled: false
  prom-exporter:
    enabled: true
    containerPort: 8889
    servicePort: 8889
    protocol: TCP

Isso nos permite usar um coletor autônomo com o exportador Prometheus sendo exposto no porto 8889. Para expor as métricas do Prometheus, estamos pedindo ao gráfico Helm para configurar um LoadBalancer serviço.

Nota

Estamos desativando a porta Jaeger compacta, pois ela usa UDP e LoadBalancer o serviço não permite que você tenha vários protocolos ao mesmo tempo.

Instale o gráfico Helm com a nossa configuração:

helm install opentelemetry-collector open-telemetry/opentelemetry-collector --values .\opentelemetry-collector-config.yml

Verifique a instalação obtendo todos os recursos para o nosso gráfico Helm

$ kubectl get all -l app.kubernetes.io/instance=opentelemetry-collector
NAME                                           READY   STATUS    RESTARTS   AGE
pod/opentelemetry-collector-58477c8c89-dstwd   1/1     Running   0          27m

NAME                              TYPE           CLUSTER-IP     EXTERNAL-IP    PORT(S)                                                                                       AGE
service/opentelemetry-collector   LoadBalancer   10.0.175.135   20.103.18.53   14250:30982/TCP,14268:32461/TCP,4317:31539/TCP,4318:31581/TCP,8889:32420/TCP,9411:30003/TCP   27m

NAME                                      READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/opentelemetry-collector   1/1     1            1           27m

NAME                                                 DESIRED   CURRENT   READY   AGE
replicaset.apps/opentelemetry-collector-58477c8c89   1         1         1       27m

Tome nota do IP externo do serviço, para que possamos consultá-lo mais tarde.

Com nosso OpenTelemetry Collector instalado, agora podemos implantar o gateway auto-hospedado em nosso cluster.

Implantar o gateway auto-hospedado

Importante

Para obter uma visão geral detalhada sobre como implantar o gateway auto-hospedado com o Helm e como obter a configuração necessária, recomendamos a leitura deste artigo.

Nesta seção, implantaremos o gateway auto-hospedado em nosso cluster com o Helm e o configuraremos para enviar métricas OpenTelemetry para o OpenTelemetry Collector.

Instale o gráfico Helm e configure-o para usar métricas OpenTelemetry :

helm install azure-api-management-gateway \
             --set gateway.configuration.uri='<your configuration url>' \
             --set gateway.auth.key='<your auth token>' \
             --set observability.opentelemetry.enabled=true \
             --set observability.opentelemetry.collector.uri=http://opentelemetry-collector:4317 \
             --set service.type=LoadBalancer \
             azure-apim-gateway/azure-api-management-gateway

Nota

opentelemetry-collector no comando acima é o nome do OpenTelemetry Collector. Atualize o nome se o serviço tiver um nome diferente.

Verifique a instalação obtendo todos os recursos para o nosso gráfico Helm

$ kubectl get all -l app.kubernetes.io/instance=apim-gateway
NAME                                                            READY   STATUS    RESTARTS   AGE
pod/apim-gateway-azure-api-management-gateway-fb77c6d49-rffwq   1/1     Running   0          63m

NAME                                                TYPE           CLUSTER-IP    EXTERNAL-IP    PORT(S)                         AGE
service/apim-gateway-azure-api-management-gateway   LoadBalancer   10.0.67.177   20.71.82.110   8080:32267/TCP,8081:32065/TCP   63m

NAME                                                        READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/apim-gateway-azure-api-management-gateway   1/1     1            1           63m

NAME                                                                  DESIRED   CURRENT   READY   AGE
replicaset.apps/apim-gateway-azure-api-management-gateway-fb77c6d49   1         1         1       63m

Anote o IP externo do serviço do gateway auto-hospedado, para que possamos consultá-lo mais tarde.

Gerar e consumir as métricas OpenTelemetry

Agora que nosso OpenTelemetry Collector e o gateway auto-hospedado estão implantados, podemos começar a consumir as APIs para gerar métricas.

Nota

Estaremos consumindo a "API Echo" padrão para este passo a passo.

Certifique-se de que está configurado para:

Permitir solicitações HTTP
Permita que seu gateway auto-hospedado o exponha

Consulte a API Echo no gateway auto-hospedado:

$ curl -i "http://<self-hosted-gateway-ip>:8080/echo/resource?param1=sample&subscription-key=abcdef0123456789"
HTTP/1.1 200 OK
Date: Mon, 20 Dec 2021 12:58:09 GMT
Server: Microsoft-IIS/8.5
Content-Length: 0
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Accept: */*
Host: echoapi.cloudapp.net
User-Agent: curl/7.68.0
X-Forwarded-For: 10.244.1.1
traceparent: 00-3192030c89fd7a60ef4c9749d6bdef0c-f4eeeee46f770061-01
Request-Id: |3192030c89fd7a60ef4c9749d6bdef0c.f4eeeee46f770061.
Request-Context: appId=cid-v1:c24f5e00-aa25-47f2-bbb5-035847e7f52a
X-Powered-By: Azure API Management - http://api.azure.com/,ASP.NET
X-AspNet-Version: 4.0.30319

O gateway auto-hospedado agora medirá a solicitação e enviará as métricas para o OpenTelemetry Collector.

Consultar o ponto de extremidade Prometheus no coletor em http://<collector-service-ip>:8889/metrics. Você deve ver métricas semelhantes às seguintes:

# HELP azure_apim_BackendDurationInMs 
# TYPE azure_apim_BackendDurationInMs histogram
azure_apim_BackendDurationInMs_bucket{Hostname="20.71.82.110",le="5"} 0 1640093731340
[...]
azure_apim_BackendDurationInMs_count{Hostname="20.71.82.110"} 22 1640093731340
# HELP azure_apim_ClientDurationInMs 
# TYPE azure_apim_ClientDurationInMs histogram
azure_apim_ClientDurationInMs_bucket{Hostname="20.71.82.110",le="5"} 22 1640093731340
[...]
azure_apim_ClientDurationInMs_count{Hostname="20.71.82.110"} 22 1640093731340
# HELP azure_apim_DurationInMs 
# TYPE azure_apim_DurationInMs histogram
azure_apim_DurationInMs_bucket{Hostname="20.71.82.110",le="5"} 0 1640093731340
[...]
azure_apim_DurationInMs_count{Hostname="20.71.82.110"} 22 1640093731340
# HELP azure_apim_GatewayDurationInMs 
# TYPE azure_apim_GatewayDurationInMs histogram
azure_apim_GatewayDurationInMs_bucket{Hostname="20.71.82.110",le="5"} 0 1640093731340
[...]
azure_apim_GatewayDurationInMs_count{Hostname="20.71.82.110"} 22 1640093731340
# HELP azure_apim_Requests 
# TYPE azure_apim_Requests counter
azure_apim_Requests{BackendResponseCode="200",BackendResponseCodeCategory="2xx",Cache="None",GatewayId="Docs",Hostname="20.71.82.110",LastErrorReason="None",Location="GitHub",ResponseCode="200",ResponseCodeCategory="2xx",Status="Successful"} 22 1640093731340

Limpeza

Agora que o tutorial terminou, você pode limpar facilmente seu cluster da seguinte maneira:

Desinstale o gráfico Helm do gateway auto-hospedado:
```
helm uninstall apim-gateway
```
Desinstale o OpenTelemetry Collector:
```
helm uninstall opentelemetry-collector
```

Próximos passos

Para saber mais sobre o gateway auto-hospedado, consulte Visão geral do gateway auto-hospedado.

Para saber mais sobre os recursos de observabilidade dos gateways de Gerenciamento de API do Azure.

Implantar gateway auto-hospedado no cluster Kubernetes habilitado para Azure Arc

Implante gateway auto-hospedado no Kubernetes com integração OpenTelemetry

Pré-requisitos

Introdução ao OpenTelemetry

Métricas

Implantar o OpenTelemetry Collector

Implantar o gateway auto-hospedado

Gerar e consumir as métricas OpenTelemetry

Limpeza

Próximos passos

Recursos adicionais