O Pub/Sub gera registros de auditoria que capturam atividades administrativas e de acesso dos recursos do Pub/Sub. Alguns exemplos dessas atividades incluem a criação de um tópico, a atualização de uma assinatura ou a exclusão de um snapshot. Você pode usar esses registros para solucionar problemas e garantir a segurança da sua infraestrutura de mensagens.
Confira alguns pontos importantes a serem lembrados sobre os registros de auditoria no Pub/Sub:
Os registros de auditoria do Pub/Sub usam o nome de serviço
pubsub.googleapis.com.O Pub/Sub tem diferentes tipos de registros. Isso inclui o seguinte:
Os registros de atividades do administrador registram ações como criar, excluir ou atualizar tópicos e assinaturas.
Os registros de acesso a dados registram ações como recuperar um tópico ou listar assinaturas.
Os registros de eventos do sistema registram eventos como a remoção de assinaturas inativas.
O Pub/Sub não registra operações de mensagens, como publicar, assinar ou confirmar mensagens.
Para mais informações sobre os registros de auditoria do Pub/Sub, consulte Geração de registros de auditoria.
Ver registros de auditoria do Pub/Sub
A Análise de registros oferece um local centralizado para acessar todos os dados de registro no Google Cloud. Você pode usar a Análise de registros para ver os registros do Pub/Sub.
Receba as permissões necessárias para acessar a Análise de registros.
Para mais informações, consulte Antes de começar.
No Google Cloud console do, acesse a página Análise de registros.
Selecione um Google Cloud projeto, uma pasta ou uma organização do.
Para mostrar todos os registros de auditoria relacionados ao Pub/Sub, insira a seguinte consulta no campo do editor de consultas:
protoPayload.serviceName="pubsub.googleapis.com"
Figura 1 Insira uma consulta. Clique em Executar consulta.
Para exibir os registros de auditoria de determinado recurso e tipo, no painel Criador de consultas, faça o seguinte:
Em Todos os recursos, selecione o Google Cloud recurso do com os registros de auditoria que você quer acessar. Por exemplo, selecione Tópico do Cloud Pub/Sub e, em seguida, o nome do tópico.
Em Todos os nomes de registro, selecione o tipo de registro de auditoria que você quer acessar.
Exemplo:
Para registros de auditoria de atividade do administrador, selecione
activity.Para registros de auditoria de eventos do sistema, selecione
system_event.
A consulta é executada automaticamente.
Como usar registros de auditoria para solucionar problemas do Pub/Sub
Determine o problema específico que você está investigando. Confira uma lista de possíveis problemas:
Identifique quem criou, excluiu ou modificou tópicos, assinaturas, snapshots ou esquemas.
Acompanhe as mudanças nas configurações de tópicos ou assinaturas.
Verifique se um tópico ou assinatura existe e qual é o status atual dele.
No entanto, não é possível usar registros de auditoria para solucionar problemas relacionados à publicação e entrega de mensagens. Não é possível encontrar registros de falhas na entrega de mensagens, duplicação de mensagens ou problemas de ordenação de mensagens. Os registros de auditoria também não ajudam a identificar assinantes lentos ou problemas com confirmações de mensagens. Para solucionar problemas de mensagens, você precisa usar outras ferramentas, como métricas de monitoramento, filas de mensagens não entregues e registros de aplicativos.
Com base no problema, crie uma consulta para filtrar os registros de auditoria. Por exemplo, para descobrir quem excluiu uma assinatura, filtre por
protoPayload.methodName="google.pubsub.v1.Publisher.DeleteSubscription".Para investigar um possível erro ao criar uma assinatura, filtre por
protoPayload.methodName="google.pubsub.v1.Subscriber.CreateSubscription".Examine os carimbos de data/hora, os principais e os nomes de recursos nas entradas de registro para entender a sequência de eventos e identificar anomalias.
Para mais informações sobre como criar uma consulta de registro de auditoria para o Pub/Sub, consulte Geração de registros de auditoria.