Gerenciar o Amazon Managed Service for Prometheus com controladores da AWS para Kubernetes

Use os comandos a seguir para usar o Helm para instalar o controlador de serviço do Amazon Managed Service for Prometheus. Para obter mais informações, consulte Instalar um controlador ACK na documentação do AWS Controllers para Kubernetes no GitHub. Use a região correta para seu sistema, como us-east-1.

export SERVICE=prometheusservice
export RELEASE_VERSION=`curl -sL https://api.github.com/repos/aws-controllers-k8s/$SERVICE-controller/releases/latest | jq -r '.tag_name | ltrimstr("v")'`
export ACK_SYSTEM_NAMESPACE=ack-system
export AWS_REGION=region

aws ecr-public get-login-password --region us-east-1 | helm registry login --username AWS --password-stdin public.ecr.aws
helm install --create-namespace -n $ACK_SYSTEM_NAMESPACE ack-$SERVICE-controller \
  oci://public.ecr.aws/aws-controllers-k8s/$SERVICE-chart --version=$RELEASE_VERSION --set=aws.region=$AWS_REGION

Após alguns instantes, você verá um resultado semelhante ao seguinte, indicando êxito.

You are now able to create Amazon Managed Service for Prometheus (AMP) resources!
The controller is running in "cluster" mode.
The controller is configured to manage AWS resources in region: "us-east-1"

Opcionalmente, você pode verificar se o controlador do AWS Controllers for Kubernetes foi instalado com êxito com o comando a seguir.

helm list --namespace $ACK_SYSTEM_NAMESPACE -o yaml

Isso retornará informações sobre o controlador ack-prometheusservice-controller, incluindo o status: deployed.

Crie um arquivo denominado workspace.yaml com o seguinte texto. Ele será usado como configuração para o espaço de trabalho que você está criando.

apiVersion: prometheusservice.services.k8s.aws/v1alpha1
kind: Workspace
metadata:
  name: my-amp-workspace
spec:
  alias: my-amp-workspace
  tags:
    ClusterName: EKS-demo

Execute o comando a seguir para criar seu espaço de trabalho (esse comando depende das variáveis do sistema que você configurou na etapa 1).

kubectl apply -f workspace.yaml -n $ACK_SYSTEM_NAMESPACE

Em alguns instantes, você poderá ver um novo espaço de trabalho, chamado my-amp-workspace em sua conta.

Executando o comando a seguir para visualizar os detalhes e o status do seu espaço de trabalho, incluindo o ID do espaço de trabalho. Como alternativa, você pode visualizar o novo espaço de trabalho no console do Amazon Managed Service for Prometheus.

kubectl describe workspace my-amp-workspace -n $ACK_SYSTEM_NAMESPACE

Crie dois arquivos yaml como configuração para o Rulegroups e o AlertManager que você criará em seguida usando a configuração a seguir.

Salve essa configuração como rulegroup.yaml. Substitua WORKSPACE-ID pelo ID do espaço de trabalho da etapa anterior.

apiVersion: prometheusservice.services.k8s.aws/v1alpha1
kind: RuleGroupsNamespace
metadata:
  name: default-rule
spec:
  workspaceID: WORKSPACE-ID
  name: default-rule
  configuration: |
    groups:
    - name: example
      rules:
      - alert: HostHighCpuLoad
        expr: 100 - (avg(rate(node_cpu_seconds_total{mode="idle"}[2m])) * 100) > 60
        for: 5m
        labels:
          severity: warning
          event_type: scale_up
        annotations:
          summary: Host high CPU load (instance {{ $labels.instance }})
          description: "CPU load is > 60%\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
      - alert: HostLowCpuLoad
        expr: 100 - (avg(rate(node_cpu_seconds_total{mode="idle"}[2m])) * 100) < 30
        for: 5m
        labels:
          severity: warning
          event_type: scale_down
        annotations:
          summary: Host low CPU load (instance {{ $labels.instance }})
          description: "CPU load is < 30%\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

Salve a configuração a seguir como alertmanager.yaml. Substitua WORKSPACE-ID pelo ID do espaço de trabalho da etapa anterior. Substitua TOPIC-ARN pelo ARN do tópico do Amazon SNS para enviar notificações e REGION pela Região da AWS que você está usando. Lembre-se de que o Amazon Managed Service for Prometheus deve ter permissões para o tópico do Amazon SNS.

apiVersion: prometheusservice.services.k8s.aws/v1alpha1
kind: AlertManagerDefinition
metadata:
  name: alert-manager
spec:
  workspaceID: WORKSPACE-ID
  configuration: |
    alertmanager_config: |
      route:
         receiver: default_receiver
      receivers:
        - name: default_receiver
          sns_configs:
          - topic_arn: TOPIC-ARN
            sigv4:
              region: REGION
            message: |
              alert_type: {{ .CommonLabels.alertname }}
              event_type: {{ .CommonLabels.event_type }}

Execute os comandos a seguir para criar seu grupo de regras e a configuração do gerenciador de alertas (esse comando depende das variáveis do sistema que você configurou na etapa 1).

kubectl apply -f rulegroup.yaml -n $ACK_SYSTEM_NAMESPACE
kubectl apply -f alertmanager.yaml -n $ACK_SYSTEM_NAMESPACE

As mudanças estarão disponíveis em instantes.

kubectl delete ResourceType ResourceName -n $ACK_SYSTEM_NAMESPACE

Use o comando a seguir para obter o prometheusEndpoint para o espaço de trabalho. Substitua WORKSPACE-ID pelo ID do espaço de trabalho da seção anterior.

aws amp describe-workspace --workspace-id WORKSPACE-ID

O prometheusEndpoint estará nos resultados de retorno e será formatado assim:

https://aps-workspaces.us-west-2.amazonaws.com/workspaces/ws-a1b2c3d4-a123-b456-c789-ac1234567890/

Salve esse URL para uso nas próximas etapas.

Crie um arquivo com o texto a seguir e chame-o de prometheus-config.yaml. Substitua account pelo ID da sua conta, workspaceURL/ pelo URL que você acabou de encontrar e region pela Região da AWS apropriada para o seu sistema.

serviceAccounts:
        server:
            name: "amp-iamproxy-ingest-service-account"
            annotations:
                eks.amazonaws.com/role-arn: "arn:aws:iam::account:role/amp-iamproxy-ingest-role"
server:
    remoteWrite:
        - url: workspaceURL/api/v1/remote_write
          sigv4:
            region: region
          queue_config:
            max_samples_per_send: 1000
            max_shards: 200
            capacity: 2500

Encontre os nomes do gráfico e do namespace do Prometheus, bem como a versão do gráfico, com o seguinte comando Helm.

helm ls --all-namespaces

Com base nas etapas até aqui, o gráfico e o namespace do Prometheus devem ser nomeados prometheus, e a versão do gráfico pode ser 15.2.0

Execute o comando a seguir usando o PrometheusChartName, o PrometheusNamespace e o PrometheusChartVersion encontrados na etapa anterior.

helm upgrade PrometheusChartName prometheus-community/prometheus -n PrometheusNamespace -f prometheus-config.yaml --version PrometheusChartVersion

Depois de alguns minutos, você verá uma mensagem informando que a atualização ocorreu com êxito.

Opcionalmente, valide se as métricas estão sendo enviadas com êxito consultando o endpoint do Amazon Managed Service for Prometheus via awscurl. Substitua Região pela Região da AWS que você está usando e workspaceURL/ pelo URL encontrado na etapa 1.

awscurl --service="aps" --region="Region" "workspaceURL/api/v1/query?query=node_cpu_seconds_total"