Gerenciando eventos do Amazon DocumentDB - Amazon DocumentDB
Exibição de categorias de eventosVisualizando eventos do Amazon DocumentDB

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á.

Gerenciando eventos do Amazon DocumentDB

O Amazon DocumentDB (compatível 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 AWS CLI describe-event-categories operação para visualizar o mapeamento entre os tipos de eventos 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 AWS CLI describe-events ou a operação de API do Amazon DescribeEventsDocumentDB. Se você usar a API do Amazon DocumentDB AWS CLI ou a API do Amazon DocumentDB para visualizar eventos, poderá recuperar eventos dos ú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 e abra AWS Management Console 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.

    Captura de tela da seção de eventos mostrando eventos de filtragem para snapshots.
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 nos últimos 7 dias executando a AWS CLI operação describe-events com o --duration parâmetro definido como (10.080 minutos). 10080

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 Auditar eventos do Amazon DocumentDB.