As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Logs compatíveis e campos descobertos

CloudWatch O Logs Insights oferece suporte a diferentes tipos de registros. Para cada registro enviado para um grupo de registros da classe Standard no Amazon CloudWatch Logs, o CloudWatch Logs Insights gera automaticamente cinco campos do sistema:

CloudWatch O Logs Insights insere o símbolo @ no início dos campos que ele gera.

Para muitos tipos de registro, o CloudWatch Logs também descobre automaticamente os campos de registro contidos nos registros. Esses campos de descoberta automática são mostrados na tabela a seguir.

Para outros tipos de registros com campos que o CloudWatch Logs Insights não descobre automaticamente, você pode usar o parse comando para extrair e criar campos extraídos para uso nessa consulta. Para obter mais informações, consulte CloudWatch Sintaxe de consulta de linguagem do Logs Insights.

Se o nome de um campo de registro descoberto começar com o @ caractere, o CloudWatch Logs Insights o exibirá com um adicional @ anexado ao início. Por exemplo, se um nome de campo de log for @example.com, o nome desse campo será exibido como @@example.com.

Campos em JSON registros

Com o CloudWatch Logs Insights, você usa a notação de pontos para representar JSON campos. Esta seção contém um exemplo de JSON evento e trecho de código que mostra como você pode acessar JSON campos usando a notação de pontos.

Exemplo: JSON evento

{
    "eventVersion": "1.0",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn: aws: iam: : 123456789012: user/Alice",
        "accessKeyId": "EXAMPLE_KEY_ID",
        "accountId": "123456789012",
        "userName": "Alice"
    },
    "eventTime": "2014-03-06T21: 22: 54Z",
    "eventSource": "ec2.amazonaws.com",
    "eventName": "StartInstances",
    "awsRegion": "us-east-2",
    "sourceIPAddress": "192.0.2.255",
    "userAgent": "ec2-api-tools1.6.12.2",
    "requestParameters": {
        "instancesSet": {
            "items": [
                {
                    "instanceId": "i-abcde123"
                }
            ]
        }
    },
    "responseElements": {
        "instancesSet": {
            "items": [
                {
                    "instanceId": "i-abcde123",
                    "currentState": {
                        "code": 0,
                        "name": "pending"
                    },
                    "previousState": {
                        "code": 80,
                        "name": "stopped"
                    }
                }
            ]
        }
    }
}

O JSON evento de exemplo contém um objeto chamadouserIdentity. userIdentitycontém um campo chamadotype. Para representar o valor de type com notação de ponto, você usa userIdentity.type.

O JSON evento de exemplo contém matrizes que se nivelam em listas de nomes e valores de campos aninhados. Para representar o valor de instanceId para o primeiro item em requestParameters.instancesSet, use requestParameters.instancesSet.items.0.instanceId. O número 0 que é colocado antes do campo instanceID refere-se à posição dos valores para o campo items. O exemplo a seguir contém um trecho de código que mostra como você pode acessar JSON campos aninhados em um JSON evento de log.

Exemplo: consulta

fields @timestamp, @message
| filter requestParameters.instancesSet.items.0.instanceId="i-abcde123"
| sort @timestamp desc

O trecho de código mostra uma consulta que usa notação de pontos com o filter comando para acessar o valor do campo aninhado. JSON instanceId A consulta filtra as mensagens para as quais o valor de instanceId é igual a "i-abcde123" e retorna todos os eventos de log que contêm o valor especificado.