Tablestore monitoring metrics and alert rule configuration via CloudMonitor - Tablestore: Central de Documentação do Alibaba Cloud

O Tablestore integra-se ao CloudMonitor para fornecer status de execução, métricas de desempenho e dados de medição de instâncias, tabelas de dados, índices secundários, índices de pesquisa e tabelas de séries temporais. Crie regras de alerta para receber notificações quando uma métrica ultrapassar o limiar definido.

Métricas compatíveis

Cada tipo de recurso expõe um conjunto diferente de métricas. Para consultar a lista completa, visualize Métricas de monitoramento do Tablestore.

Nota

A coleta de métricas pode apresentar um pequeno atraso.
As métricas de monitoramento representam médias agregadas durante um período estatístico e não refletem picos instantâneos. O throttling depende do uso instantâneo. Uma média de monitoramento dentro do limite superior não garante que o uso instantâneo também esteja; picos momentâneos ainda podem acionar o throttling.

Permissões

Visualizar dados de monitoramento ou configure regras de alerta exige duas permissões. Para saber como concedê-las, consulte RAM policy.

Acesso total ou somente leitura ao Tablestore: AliyunOTSFullAccess ou AliyunOTSReadOnlyAccess.
Acesso total ou somente leitura ao CloudMonitor: AliyunCloudMonitorFullAccess ou AliyunCloudMonitorReadOnlyAccess.

Visualize dados de monitoramento

Visualize os dados de monitoramento por um dos seguintes pontos de entrada:

Console do Tablestore: visualize dados de monitoramento de instâncias, tabelas de dados, índices e tabelas de séries temporais, além de dados de medição de índices de pesquisa.
CloudMonitor: visualize dados de monitoramento no nível da instância e da tabela pelo console, API ou SDK.

Visualize no console do Tablestore

Instância

Faça login no console do Tablestore. Se necessário, alterne a região e o grupo de recursos na parte superior da página.
Na página Instances, clique em nome da instância ou em Instance Management e abra a aba Instance Monitoring.
Selecione o Time Range e as métricas desejadas.

Nota
O Time Range não pode exceder 30 dias.

Tabela de dados e índice

Faça login no console do Tablestore. Se necessário, alterne a região e o grupo de recursos na parte superior da página.
Na página Instances, clique em nome da instância ou em Instance Management e, em seguida, clique em nome da tabela em Tables.
Abra a aba Monitoring Indicators, selecione a Table/Index, o Time Range e as métricas a visualizar.

Nota
O Time Range não pode exceder 30 dias.

Tabela de séries temporais

Faça login no console do Tablestore. Se necessário, alterne a região e o grupo de recursos na parte superior da página.
Na página Instances, clique em nome da instância ou em Instance Management e, em seguida, clique em nome da tabela em Time Series Tables.
Abra a aba Monitoring Indicators e selecione o Time Range para visualização.

Nota
O Time Range não pode exceder 30 dias.

Medição de índice de pesquisa

Faça login no console do Tablestore. Se necessário, alterne a região e o grupo de recursos na parte superior da página.
Na página Instances, clique em nome da instância ou em Instance Management. Em seguida, em Tables, clique em Indexes na tabela de dados desejada.
Clique em Index Details para visualizar os dados de Index Meters.

Visualize no CloudMonitor

Console do CloudMonitor

Faça login no console do CloudMonitor.
No painel de navegação à esquerda, clique em Dashboards e escolha Storage and CDN > Table Store.
Selecione uma região e clique em nome da instância desejada ou em Monitoring Charts.
Escolha um intervalo de tempo predefinido ou especifique um personalizado. O intervalo não pode exceder 31 dias.

API

Chame a operação DescribeMetricList do CloudMonitor para recuperar dados de uma métrica específica. Os parâmetros de solicitação para o Tablestore são:

Parâmetro	Descrição
Namespace	Identifica o service cloud a monitorar. Para o Tablestore, o Namespace é sempre `acs_ots_new`.
MetricName	A métrica a consultar (por exemplo, `Count2xxNumber`). Para a lista completa de métricas, consulte Métricas de monitoramento do Tablestore.
Dimensions	Uma string JSON que identifica a instância ou tabela a consultar. Para métricas no nível da instância, defina `instanceName`. Para métricas no nível da tabela, defina `tableName`. Para restringir uma consulta a uma operação específica, defina `operation` em Dimensions com o nome da API. Para mais detalhes, consulte API overview. Nota Nem toda métrica suporta a dimensão `operation`. Verifique a página de Métricas de monitoramento do Tablestore para confirmar as dimensões compatíveis com cada métrica.
StartTime e EndTime	O intervalo de tempo da consulta. O intervalo é aberto à esquerda e fechado à direita: `(StartTime, EndTime]`, portanto os dados em EndTime estão incluídos. Use o formato `yyyy-MM-dd HH:mm:ss` ou um timestamp Unix em milissegundos.
Period	A granularidade da consulta, em segundos. Um `Period` maior retém dados por mais tempo e permite uma janela de consulta mais longa. Para limites de retenção e intervalo de tempo, consulte DescribeMetricList.

SDK

O CloudMonitor SDK oferece suporte a Java, Python, Go e TypeScript. O exemplo abaixo utiliza o Java SDK para consultar a métrica Count2xxNumber da tabela de dados mytable na instância myinstance durante um determinado intervalo de tempo.

import com.aliyun.cms20190101.Client;
import com.aliyun.cms20190101.models.DescribeMetricListRequest;
import com.aliyun.cms20190101.models.DescribeMetricListResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

public class DescribeMetricListExample {

    public static Client createClient() throws Exception {
        Config config = new Config()
            .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
            .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // Set the CloudMonitor endpoint. It must match the region of the Tablestore instance.
        config.endpoint = "metrics.cn-hangzhou.aliyuncs.com";
        return new Client(config);
    }

    public static void main(String[] args) throws Exception {
        Client client = createClient();

        DescribeMetricListRequest request = new DescribeMetricListRequest()
            // The Namespace for Tablestore monitoring is fixed to acs_ots_new.
            .setNamespace("acs_ots_new")
            // Set the name of the metric to query. For example, Count2xxNumber indicates the number of 2xx requests per second.
            .setMetricName("Count2xxNumber")
            // For table-level metrics, both instanceName and tableName must be specified in Dimensions.
            .setDimensions("{\"instanceName\":\"myinstance\",\"tableName\":\"mytable\"}")
            // The query period, in seconds.
            .setPeriod("60")
            // The time format can be yyyy-MM-dd HH:mm:ss or a millisecond timestamp.
            .setStartTime("2026-06-22 06:00:00")
            .setEndTime("2026-06-22 07:00:00");

        RuntimeOptions runtime = new RuntimeOptions();
        DescribeMetricListResponse response = client.describeMetricListWithOptions(request, runtime);

        // Datapoints is a JSON string containing fields such as timestamp, Average, Maximum, Minimum, and Sum.
        System.out.println("RequestId: " + response.body.getRequestId());
        System.out.println("Datapoints: " + response.body.getDatapoints());
    }
}

Configure alertas de métricas

Após a configuração das regras de alerta para métricas do Tablestore, o CloudMonitor envia automaticamente uma notificação quando uma métrica ultrapassa o limiar. Para etapas de configuração, consulte Create an alert rule.

Nota

Um Alert Contact Group é obrigatório ao criar uma regra de alerta. Crie-o antes de configure a regra. Para mais detalhes, consulte Create an alert contact or an alert contact group.
Ao gerencie muitos recursos cloud, agrupe-os por aplicação e crie modelos de alerta para aplicar aos grupos. Essa prática facilita a criação e a manutenção das regras de alerta. Para mais detalhes, consulte Apply an alert template to application groups.