Compute Nest:Configure monitoring and alerts for fully managed services - ACK deployment solution

Etapa 1: Configurar o Managed Service for Prometheus para o ACK

Por padrão, o Prometheus não suporta encaminhamento de métricas. Aplique configurações adicionais no Managed Service for Prometheus para encaminhar métricas de monitoramento de aplicações a usuários específicos.

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "arms:GetPrometheusApiToken"
      ],
      "Resource": "*"
    }
  ]
}

Etapa 2: Configurar o modelo ROS

1. Crie um namespace com o nome do ID da instância de service e adicione rótulos de tenant a ele.

   Nota

   As chaves dos rótulos de tenant são tenant_userid, tenant_clusterid, tenant_token e tenant_cloudproductcode. O modelo ROS utiliza placeholders para esses valores. O namespace recebe o nome do placeholder {{ serviceInstanceId }}, substituído pelo ID da service instance criada.

   ClusterNameSpaceApplication:
       Type: ALIYUN::CS::ClusterApplication
       Properties:
         YamlContent:
           Fn::Sub:
             - |
               apiVersion: v1
               kind: Namespace
               metadata:
                 name: '${Name}'
                 labels:
                   tenant_userid: '{{ aliUid }}'
                   tenant_clusterid: '{{ tenantClusterId }}'
                   tenant_token: '{{ tenantToken }}'
                   tenant_cloudproductcode: '{{ tenantCloudProductCode }}'
             - Name: '{{ serviceInstanceId }}'
         ClusterId:
           Fn::If:
             - Condition: CreateACKCondition
             - Ref: ManagedKubernetesCluster
             - Ref: ClusterId

   Importante

   Implante a aplicação do provedor de service no namespace criado na etapa anterior para garantir que as métricas de monitoramento sejam roteadas ao tenant correto.

2. (Opcional) No cenário de service totalmente gerenciado single-tenant, use o módulo AckArmsConfig no modelo ROS para configurar o Managed Service for Prometheus em cada novo cluster ACK criado.

3. (Opcional) Para coletar métricas personalizadas, exponha-as por uma porta HTTP ou com um exporter. Nomeie o Service que expõe as métricas como {{ serviceInstanceId }} e defina um ServiceMonitor para descoberta de serviços. O exemplo a seguir mostra o Service e o ServiceMonitor usados para coletar métricas do MySQL com o mysqld-exporter.

   apiVersion: v1
   kind: Service
   metadata:
     name: {{ serviceInstanceId }}
     labels:
       io.mysql.service: {{ serviceInstanceId }}
   spec:
     selector:
       app: mysql
     ports:
       - protocol: TCP
         port: 3306
         targetPort: 3306
         name: mysql
       - protocol: TCP
         port: 9104
         targetPort: 9104
         name: mysql-exporter
     type: LoadBalancer

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     name: prometheus-service-monitor
     annotations:
       arms.prometheus.io/discovery: 'true'
     labels:
       prometheus-service-monitor: prometheus-service-monitor
   spec:
     selector:
       matchLabels:
         io.mysql.service: {{ serviceInstanceId }}
     namespaceSelector:
       matchNames:
         - {{ serviceInstanceId }}
     endpoints:
       - port: mysql-exporter
         scheme: http
         path: /metrics
         interval: 10s
         scrapeTimeout: 10s

Etapa 3: Configurar o painel do Grafana

Cada instância de service suporta apenas um painel. Caso tenha múltiplos painéis, consolide-os em um único. O painel deve atender ao seguinte requisito:

Crie uma variável de painel chamada Namespace e use-a como filtro global para as métricas de monitoramento da aplicação. Crie o painel no Managed Service for Grafana e obtenha o link correspondente.

Etapa 4: Configurar o identificador do product e o link do painel

Para usar o Managed Service for Prometheus com um service totalmente gerenciado multi-tenant do Compute Nest, configure o identificador do product e as informações do painel de monitoramento.

1. Identificador do product: Identifica exclusivamente o service no sistema de monitoramento. Para testes, use o identificador compartilhado cn-mariadb, disponível nas regiões China (Hangzhou) e China (Hong Kong).

   Nota

   O uso em produção exige um identificador de product dedicado. Para obter um, entre no grupo de suporte técnico mencionado no início deste tópico.

2. As configurações do painel de monitoramento incluem título e link do painel do Grafana, com mapeamento um para um com o identificador de product.

   Nota

   Atualmente, esta configuração requer setup manual. Entre no grupo de suporte técnico para obter assistência.

3. Abaixo está a configuração de um service de exemplo que usa o identificador cn-mariadb. Com cn-mariadb, é possível utilizar a configuração padrão do painel de monitoramento, cujo título é MySQL Exporter Quickstart and Dashboard.

Etapa 5: Configurar alertas

1. Acesse o console do ARMS para Prometheus Monitoring e crie um modelo de regra de alerta do Prometheus. Para mais informações, consulte Create a Prometheus alert rule template.

2. Após criar o modelo, obtenha o TemplateId nas requisições de rede do console, conforme descrito abaixo.

   Importante

   A requisição de rede correspondente aparece somente após aplicar um filtro de busca.

   Na página de modelos de regras de alerta, use a lista suspensa static threshold na parte superior para filtrar e pesquisar. Uma requisição alert.json?action=AlertTemplateAction aparecerá no painel Network das DevTools do navegador. Clique em na requisição e visualize a aba Response. No JSON retornado, localize o campo id (por exemplo, d9a9fb3b-47a9-4338-84f5-93240e03b4ee). Este valor corresponde ao TemplateId necessário.

3. No modelo ROS, defina e aplique o modelo de regra de alerta ao cluster ACK com o recurso ALIYUN::ARMS::ApplyAlertRuleTemplate para criar as regras de alerta correspondentes no cluster. O exemplo a seguir mostra um trecho do modelo ROS.

   ROSTemplateFormatVersion: '2015-09-01'
   Description:
     en: ApplyAlertRule
     zh-cn: ApplyAlertRule
   Parameters:
     ClusterIds:
       AssociationPropertyMetadata:
         Parameter:
           Required: true
           Type: String
           Description:
             en: The ID of the Prometheus Instance.
       Description:
         en: The IDs list of Prometheus Instances.
       Default: Null
       MinLength: 1
       Required: false
       MaxLength: 100
       AssociationProperty: List[Parameter]
       Type: Json
     TemplateIds:
       AssociationPropertyMetadata:
         Parameter:
           Required: true
           Type: String
           Description:
             en: The ID of the Prometheus alert rule template.
       Description:
         en: The IDs list of Prometheus alert rule templates.
       Default: Null
       MinLength: 1
       Required: false
       MaxLength: 100
       AssociationProperty: List[Parameter]
       Type: Json
   Resources:
     ApplyAlertRuleTemplate:
       Type: ALIYUN::ARMS::ApplyAlertRuleTemplate
       Properties:
         ClusterIds:
           Ref: ClusterIds
         TemplateIds:
           Ref: TemplateIds

Etapa 6: Visualizar dados de monitoramento

Após a implantação da instância de service, tanto o tenant quanto o provedor de service podem visualizar o painel de monitoramento na página de detalhes da instância.

• Visualização do tenant:

• Visualização do provedor de service: