Container Service for Kubernetes:Configurar alertas para um cluster registrado

Usando onectl

1. Instale e configure o onectl na sua máquina local. Para mais informações, consulte Gerenciar clusters registrados usando onectl.

2. Conceda permissões RAM ao componente CloudMonitor.

   onectl ram-user grant --addon alicloud-monitor-controller

   Saída esperada:

   Ram policy ack-one-registered-cluster-policy-alicloud-monitor-controller granted to ram user ack-one-user-ce313528c3 successfully.

Usando o console

Antes de instalar um add-on em um cluster registrado, crie um usuário RAM com as permissões necessárias e obtenha um par de AccessKey para acessar os serviços da Alibaba Cloud.

1. Criar um usuário RAM.

2. Criar uma política personalizada. Exemplo:

   {
               "Action": [
                   "log:*",
                   "arms:*",
                   "cms:*",
                   "cs:UpdateContactGroup"
               ],
               "Resource": [
                   "*"
               ],
               "Effect": "Allow"
   }

3. Gerenciar permissões de usuário RAM.

4. Criar um AccessKey para o usuário RAM.

   Aviso

   Para maior segurança, configure uma política de controle de acesso à rede para o AccessKey, restringindo o acesso a ambientes de rede confiáveis. Para mais informações, consulte Políticas de restrição de acesso à rede baseadas em AccessKey.

5. Use o par de AccessKey para criar um Secret chamado alibaba-addon-secret no cluster registrado.

   O componente CloudMonitor utiliza este par de AccessKey para acessar recursos da cloud.

   kubectl -n kube-system create secret generic alibaba-addon-secret --from-literal='access-key-id=<your access key id>' --from-literal='access-key-secret=<your access key secret>'

   Nota

   Substitua <your access key id> e <your access key secret> pelo seu par de AccessKey.

Usando onectl

Instale o componente CloudMonitor.

onectl addon install alicloud-monitor-controller

Saída esperada:

Addon alicloud-monitor-controller, version **** installed.

Usando o console

O console verifica os requisitos de alerta e orienta você a ativar, instalar ou atualizar o componente.

1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Operations > Alerts.

3. Na página Alerts, siga as instruções na tela para instalar ou atualizar os componentes necessários.

4. Após a instalação ou atualização, acesse a página Alerts para configurar os alertas.

   Aba	Descrição
   Alert Rules	Status: Ative ou desative um conjunto de regras de alerta. Edit Contact Group: Defina o grupo de contatos para notificações de alerta. As notificações são enviadas apenas para grupos de contatos. Crie contatos e grupos primeiro. Para notificar um indivíduo, crie um grupo dedicado para esse contato.
   Alert History	Visualize até 100 registros de alerta das últimas 24 horas. Clique em um link na coluna Alert Rule para visualizar as configurações da regra no sistema de monitoramento correspondente. Clique em Details para navegar até a página do recurso relacionado à anomalia. Clique em Intelligent Analytics para análise e solução de problemas com IA.
   Alert Contacts	Crie, edite ou exclua contatos. Métodos de contato: Chamada telefônica/SMS: Defina um número de celular para que o contato receba alertas por telefone e SMS. Apenas números de celular verificados podem receber notificações por chamada telefônica. Consulte Verificar um número de celular. E-mail: Defina um endereço de e-mail para que o contato receba notificações de alerta. Chatbots: chatbots do DingTalk, chatbots do WeCom e chatbots do Lark. Para chatbots do DingTalk, adicione palavras-chave de segurança: alert, dispatch. Verifique as notificações por e-mail e chatbot no console do CloudMonitor em Alerts > Alert Contacts antes de configurá-las.
   Alert Contact Groups	Crie, edite ou exclua grupos de contatos. Se nenhum grupo de contatos existir, o console criará um grupo padrão a partir da sua conta Alibaba Cloud.

Console

1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Operations > Alerts.

3. Na aba Alert Rules, clique em Configure Alert Rule no canto superior direito. Em seguida, na coluna Actions da regra desejada, clique em YAML para visualizar a configuração do recurso CRD AckAlertRule.

4. Modifique o arquivo YAML. Consulte Modelo de regra de alerta padrão para detalhes dos parâmetros.

   O exemplo a seguir mostra a configuração YAML de uma regra de alerta:

   Configuração YAML da regra de alerta

   apiVersion: alert.alibabacloud.com/v1beta1
   kind: AckAlertRule
   metadata:
     name: default
   spec:
     groups:
       # The following is a sample configuration for a cluster event alert rule.
       - name: pod-exceptions                             # The name of the alert rule group, which corresponds to the Group_Name field in the alert template.
         rules:
           - name: pod-oom                                # The name of the alert rule.
             type: event                                  # The type of the alert rule (Rule_Type). Valid values: event, metric-cms (CloudMonitor metric), and metric-prometheus (Prometheus metric).
             expression: sls.app.ack.pod.oom              # The alert rule expression. If the rule type is event, the value is the Rule_Expression_Id from the default alert rule template in this topic.
             enable: enable                               # The state of the alert rule. Valid values: enable and disable.
           - name: pod-failed
             type: event
             expression: sls.app.ack.pod.failed
             enable: enable
       # The following is a sample configuration for a cluster infrastructure resource alert rule.
       - name: res-exceptions                              # The name of the alert rule group, which corresponds to the Group_Name field in the alert template.
         rules:
           - name: node_cpu_util_high                      # The name of the alert rule.
             type: metric-cms                              # The type of the alert rule (Rule_Type). Valid values: event, metric-cms (CloudMonitor metric), and metric-prometheus (Prometheus metric).
             expression: cms.host.cpu.utilization          # The alert rule expression. If the rule type is metric-cms, the value is the Rule_Expression_Id from the default alert rule template in this topic.
             contactGroups:                                # The contact groups mapped to the alert rule. This configuration is generated by the ACK console. Contacts are consistent for a single account and can be reused across multiple clusters.
               - arms_contact_group_id_v2: '69xxx'
                 cms_contact_group_name: xxx Contact Group
                 id: '10xxx'
             enable: enable                                # The state of the alert rule. Valid values: enable and disable.
             thresholds:                                   # The threshold of the alert rule.
               - key: CMS_ESCALATIONS_CRITICAL_Threshold
                 unit: percent
                 value: '85'                                # CPU utilization threshold. Default value: 85%.
               - key: CMS_ESCALATIONS_CRITICAL_Times
                 value: '3'                                # An alert is triggered if the threshold is exceeded 3 consecutive times.
               - key: CMS_RULE_SILENCE_SEC                 # The silence period after the first alert is reported.
                 value: '900'    

   Use rules.thresholds para personalizar limiares de alerta. Por exemplo, a configuração anterior aciona um alerta quando a utilização da CPU de um nó excede 85% por três vezes consecutivas e mais de 900 segundos se passaram desde o último alerta.

   Parâmetro	Obrigatório	Descrição	Padrão
   CMS_ESCALATIONS_CRITICAL_Threshold	Sim	O limiar para a regra de alerta. Se este parâmetro for omitido, a sincronização da regra falhará e a regra será desativada. unit: A unidade do limiar. Valores válidos: percent, count e qps. value: O valor do limiar.	Varia conforme o modelo de regra de alerta padrão.
   CMS_ESCALATIONS_CRITICAL_Times	Opcional	O número de vezes consecutivas que a condição deve ser atendida antes que o CloudMonitor acione um alerta. Se este parâmetro for omitido, o valor padrão será usado.	3
   CMS_RULE_SILENCE_SEC	Opcional	O período de silêncio em segundos após o relatório de um alerta inicial para uma regra do CloudMonitor que dispara continuamente. Isso evita fadiga de alertas. Se este parâmetro for omitido, o valor padrão será usado.	900

CLI

1. Edite o arquivo YAML da regra de alerta:

   kubectl edit ackalertrules default -n kube-system

2. Modifique o arquivo YAML, salve e saia. Consulte Modelo de regra de alerta padrão para detalhes dos parâmetros.

   Configuração YAML da regra de alerta

   apiVersion: alert.alibabacloud.com/v1beta1
   kind: AckAlertRule
   metadata:
     name: default
   spec:
     groups:
       # The following is a sample configuration for a cluster event alert rule.
       - name: pod-exceptions                             # The name of the alert rule group, which corresponds to the Group_Name field in the alert template.
         rules:
           - name: pod-oom                                # The name of the alert rule.
             type: event                                  # The type of the alert rule (Rule_Type). Valid values: event, metric-cms (CloudMonitor metric), and metric-prometheus (Prometheus metric).
             expression: sls.app.ack.pod.oom              # The alert rule expression. If the rule type is event, the value is the Rule_Expression_Id from the default alert rule template in this topic.
             enable: enable                               # The state of the alert rule. Valid values: enable and disable.
           - name: pod-failed
             type: event
             expression: sls.app.ack.pod.failed
             enable: enable
       # The following is a sample configuration for a cluster infrastructure resource alert rule.
       - name: res-exceptions                              # The name of the alert rule group, which corresponds to the Group_Name field in the alert template.
         rules:
           - name: node_cpu_util_high                      # The name of the alert rule.
             type: metric-cms                              # The type of the alert rule (Rule_Type). Valid values: event, metric-cms (CloudMonitor metric), and metric-prometheus (Prometheus metric).
             expression: cms.host.cpu.utilization          # The alert rule expression. If the rule type is metric-cms, the value is the Rule_Expression_Id from the default alert rule template in this topic.
             contactGroups:                                # The contact groups mapped to the alert rule. This configuration is generated by the ACK console. Contacts are consistent for a single account and can be reused across multiple clusters.
               - arms_contact_group_id_v2: 'xxx'
                 cms_contact_group_name: xxx
                 id: 'xxx'
             enable: enable                                # The state of the alert rule. Valid values: enable and disable.
             thresholds:                                   # The threshold of the alert rule.
               - key: CMS_ESCALATIONS_CRITICAL_Threshold
                 unit: percent
                 value: '85'                                # CPU utilization threshold. Default value: 85%.
               - key: CMS_ESCALATIONS_CRITICAL_Times
                 value: '3'                                # An alert is triggered if the threshold is exceeded 3 consecutive times.
               - key: CMS_RULE_SILENCE_SEC                 # The silence period after the first alert is reported.
                 value: '900'    

   Use rules.thresholds para personalizar limiares de alerta. Por exemplo, a configuração anterior aciona um alerta quando a utilização da CPU de um nó excede 85% por três vezes consecutivas e mais de 900 segundos se passaram desde o último alerta.

   Parâmetro	Obrigatório	Descrição	Padrão
   CMS_ESCALATIONS_CRITICAL_Threshold	Sim	O limiar para a regra de alerta. Se este parâmetro for omitido, a sincronização da regra falhará e a regra será desativada. unit: A unidade do limiar. Valores válidos: percent, count e qps. value: O valor do limiar.	Varia conforme o modelo de regra de alerta padrão.
   CMS_ESCALATIONS_CRITICAL_Times	Opcional	O número de vezes consecutivas que a condição deve ser atendida antes que o CloudMonitor acione um alerta. Se este parâmetro for omitido, o valor padrão será usado.	3
   CMS_RULE_SILENCE_SEC	Opcional	O período de silêncio em segundos após o relatório de um alerta inicial para uma regra do CloudMonitor que dispara continuamente. Isso evita fadiga de alertas. Se este parâmetro for omitido, o valor padrão será usado.	900