Métricas em representações gráficas geradas por regras no CloudWatch - Amazon CloudWatch
Definir um alarme para os dados de métrica do Contributor Insights

Métricas em representações gráficas geradas por regras no CloudWatch

O Contributor Insights fornece uma função matemática de métrica, INSIGHT_RULE_METRIC. Você pode usar essa função para adicionar dados de um relatório do Contributor Insights a um grafo na guia Metrics (Métricas) do console do CloudWatch. Você também pode definir um alarme com base nessa função matemática. Para mais informações sobre funções matemáticas de métrica, consulte Uso de expressões matemáticas com as métricas do CloudWatch.

Para usar essa função matemática de métrica, é necessário estar conectado em uma conta que tenha as permissões cloudwatch:GetMetricData e cloudwatch:GetInsightRuleReport.

A sintaxe é INSIGHT_RULE_METRIC(ruleName, metricName). ruleName é o nome de uma regra do Contributor Insights, e metricName é um dos valores na lista a seguir. O valor de metricName determina qual tipo de dados a função matemática retorna.

  • UniqueContributors: o número de colaboradores exclusivos para cada ponto de dados.

  • MaxContributorValue: o valor do principal colaborador para cada ponto de dados. A identidade do colaborador pode mudar para cada ponto de dados no gráfico.

    Se essa regra for agregada por Count, o principal colaborador de cada ponto de dados será o colaborador com mais ocorrências nesse período. Se a regra for agregada por Sum, o principal colaborador será o que tiver a maior soma no campo de log especificado pelo Value da regra durante esse período.

  • SampleCount: o número de pontos de dados correspondentes pela regra.

  • Sum: a soma dos valores de todos os colaboradores durante o período representado por esse ponto de dados.

  • Minimum: o valor mínimo de uma única observação durante o período representado por esse ponto de dados.

  • Maximum: o valor máximo de uma única observação durante o período representado por esse ponto de dados.

  • Average: o valor médio de todos os colaboradores durante o período representado por esse ponto de dados.

Definir um alarme para os dados de métrica do Contributor Insights

É possível definir alarmes em métricas geradas pelo Contributor Insights usando a função INSIGHT_RULE_METRIC. Por exemplo, você pode criar um alarme com base na porcentagem de conexões de Transmission Control Protocol (TCP – Protocolo de controle de transmissão) rejeitadas. Para começar com esse tipo de alarme, você pode criar regras como as mostradas nos dois exemplos a seguir:

Exemplo de regra: "RejectedConnectionsRule"

{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "LogGroupNames": [
        "/aws/containerinsights/sample-cluster-name/flowlogs"
    ],
    "LogFormat": "CLF",
    "Fields": {
        "3": "interfaceID",
        "4": "sourceAddress",
        "8": "protocol",
        "13": "action"
    },
    "Contribution": {
        "Keys": [
            "interfaceID",
            "sourceAddress"
        ],
        "Filters": [
            {
                "Match": "protocol",
                "EqualTo": 6
            },
            {
                "Match": "action",
                "In": [
                    "REJECT"
                ]
            }
        ]
    },
    "AggregateOn": "Sum"
}

Exemplo de regra: "TotalConnectionsRule"

{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "LogGroupNames": [
        "/aws/containerinsights/sample-cluster-name/flowlogs"
    ],
    "LogFormat": "CLF",
    "Fields": {
        "3": "interfaceID",
        "4": "sourceAddress",
        "8": "protocol",
        "13": "action"
    },
    "Contribution": {
        "Keys": [
            "interfaceID",
            "sourceAddress"
        ],
        "Filters": [{
            "Match": "protocol",
            "EqualTo": 6
        }],
        "AggregateOn": "Sum"
    }
}

Depois de criar suas regras, você pode selecionar a guia Metrics (Métricas), no Console do CloudWatch, e usar as seguintes expressões matemáticas de métrica de exemplo para representar gráficos dos dados que o Contributor Insights relata:

Exemplo: expressões matemáticas de métrica

e1 INSIGHT_RULE_METRIC("RejectedConnectionsRule", "Sum")
e2 INSIGHT_RULE_METRIC("TotalConnectionsRule", "Sum")
e3 (e1/e2)*100

No exemplo, a expressão matemática de métrica e3 retorna todas as conexões TCP rejeitadas. Se quiser ser notificado quando 20% das conexões TCP forem rejeitadas, você poderá modificar a expressão, alterando o limite de 100 para 20.

nota

Você pode criar um alarme em uma métrica que você está monitorando a partir da seção Metrics (Métricas). Enquanto estiver na guia Graphed metrics (Representar métricas em gráficos), você poderá selecionar o ícone Create alarm (Criar alarme) na coluna Actions (Ações). O ícone Create alarm (Criar alarme) parece um sino.

Para obter mais informações sobre como criar gráficos de métricas e usar funções matemáticas de métricas, consulte a seguinte seção: Adicionar uma expressão matemática a um gráfico do CloudWatch.