Gerenciando eventos do Amazon DocumentDB

O Amazon DocumentDB (compativel com MongoDB) mantém um registro de eventos que se relacionam a seus clusters, instâncias, snapshots, grupos de segurança e grupos de parâmetros do cluster. Essas informações incluem a data e a hora do evento, o nome e o tipo de origem do evento, além de uma mensagem que está associada ao evento.

Importante

Para determinados recursos de gerenciamento, o Amazon DocumentDB usa a tecnologia operacional que é compartilhada com o Amazon RDS e o Amazon Neptune. Os limites de região, limites que são governados no nível da Região, são compartilhados entre o Amazon DocumentDB, o Amazon RDS e o Amazon Neptune. Para obter mais informações, consulte Cotas regionais.

Visualização das categorias de eventos do Amazon DocumentDB

Cada tipo de recurso do Amazon DocumentDB tem tipos específicos de eventos que podem ser associados a ele. Você pode usar a operação de AWS CLI describe-event-categories para visualizar o mapeamento entre os tipos de evento e os tipos de recursos do Amazon DocumentDB.

Parâmetros

• --source-type—Opcional. Use o parâmetro --source-type para ver as categorias de evento para um determinado tipo de origem. Os seguintes valores são permitidos:

  • db-cluster

  • db-instance

  • db-parameter-group

  • db-security-group

  • db-cluster-snapshot

• --filters—Opcional. Para visualizar as categorias de eventos apenas do Amazon DocumentDB, use o filtro --filter Name=engine,Values=docdb.

O código a seguir lista as categorias de eventos associadas aos clusters.

Para Linux, macOS ou Unix:

aws docdb describe-event-categories \
    --filter Name=engine,Values=docdb \
    --source-type db-cluster

Para Windows:

aws docdb describe-event-categories ^
    --filter Name=engine,Values=docdb ^
    --source-type db-cluster

A saída dessa operação é semelhante ao seguinte (formato JSON).

{
    "EventCategoriesMapList": [
        {
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ],
            "SourceType": "db-cluster"
        }
    ]
}

O código a seguir lista as categorias de eventos associadas a cada tipo de origem do Amazon DocumentDB.

aws docdb describe-event-categories

A saída dessa operação é semelhante ao seguinte (formato JSON).

{
    "EventCategoriesMapList": [
        {
            "SourceType": "db-instance",
            "EventCategories": [
                "notification",
                "failure",
                "creation",
                "maintenance",
                "deletion",
                "recovery",
                "restoration",
                "configuration change",
                "read replica",
                "backtrack",
                "low storage",
                "backup",
                "availability",
                "failover"
            ]
        },
        {
            "SourceType": "db-security-group",
            "EventCategories": [
                "configuration change",
                "failure"
            ]
        },
        {
            "SourceType": "db-parameter-group",
            "EventCategories": [
                "configuration change"
            ]
        },
        {
            "SourceType": "db-cluster",
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ]
        },
        {
            "SourceType": "db-cluster-snapshot",
            "EventCategories": [
                "backup"
            ]
        }
    ]
}

Visualizando eventos do Amazon DocumentDB

Você pode recuperar eventos para seus recursos do Amazon DocumentDB pelo console do Amazon DocumentDB, que mostra eventos das últimas 24 horas. Você também pode recuperar eventos para seus recursos do Amazon DocumentDB usando o comando describe-events AWS CLI ou a operação DescribeEvents da API do Amazon DocumentDB. Se você usar a AWS CLI ou a API Amazon DocumentDB para visualizar eventos, poderá recuperar eventos até os últimos 14 dias.

Using the AWS Management Console

Para visualizar todos os eventos de instâncias do Amazon DocumentDB nas últimas 24 horas

1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

2. No painel de navegação, escolha Eventos. Os eventos disponíveis aparecem em uma lista.

3. Use a lista Filtro para filtrar os eventos por tipo. Insira um termo na caixa de texto para filtrar os resultados. Por exemplo, a captura de tela a seguir mostra a filtragem de todos os eventos do Amazon DocumentDB para eventos snapshot.

   

Using the AWS CLI

Para visualizar todos os eventos de instância do Amazon DocumentDB dos últimos 7 dias

Você pode visualizar todos os eventos de instância do Amazon DocumentDB dos últimos 7 dias executando a operação describe-events AWS CLI com o parâmetro --duration definido como 10080 (10.080 minutos).

aws docdb describe-events --duration 10080

Filtragem para eventos do Amazon DocumentDB

Para ver os eventos específicos do Amazon DocumentDB, use a operação describe-events com os seguintes parâmetros.

Parâmetros

• --filter—Necessário para limitar os valores retornados ao evento Amazon DocumentDB. Use Name=engine,Values=docdb para filtrar todos os eventos somente para o Amazon DocumentDB.

• --source-identifier—Opcional. O identificador da origem do evento para o qual os eventos são retornados. Se omitido, os eventos de todas as origens são incluídos nos resultados.

• --source-type—Opcional, a menos que --source-identifier seja fornecido, então é necessário. Se --source-identifier for fornecido, --source-type deve estar de acordo com o tipo do --source-identifier. Os seguintes valores são permitidos:

  • db-cluster

  • db-instance

  • db-parameter-group

  • db-security-group

  • db-cluster-snapshot

O exemplo a seguir lista todos os eventos do Amazon DocumentDB.

aws docdb describe-events --filters Name=engine,Values=docdb

A saída dessa operação é semelhante ao seguinte (formato JSON).

{
    "Events": [
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3",
            "Message": "instance created",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:17:40.023Z",
            "SourceIdentifier": "sample-cluster-instance3",
            "EventCategories": [
                "creation"
            ]
        },
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
            "Message": "instance shutdown",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:25:01.245Z",
            "SourceIdentifier": "docdb-2018-12-11-21-08-23",
            "EventCategories": [
                "availability"
            ]
        },
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
            "Message": "instance restarted",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:25:11.441Z",
            "SourceIdentifier": "docdb-2018-12-11-21-08-23",
            "EventCategories": [
                "availability"
            ]
        }
    ]
}

Para obter mais informações, consulte Auditoria de eventos do Amazon DocumentDB.