Introdução aos registros

Nesta página, descrevemos os diferentes tipos de registros disponíveis para Application Integration e quando usá-los.

Visão geral

Com a Application Integration, é possível gerar registros para as execuções de integração. É possível usar esses registros para resolver falhas de execução, monitorar o uso ou definir alertas. Há duas maneiras de acessar seus registros:

• Registros de execução da integração. Esses registros são gerados quando as integrações são executadas. Esses registros podem ser visualizados na Integração de aplicativos e no Cloud Logging.
• Registros de auditoria. Com os registros de auditoria, você pode entender quem fez o quê, onde e quando na sua integração. Esses registros só podem ser visualizados no Cloud Logging sem custos extras.

Com a Integração de aplicativos, é possível aproveitar os recursos do Cloud Logging, incluindo a definição de alertas nesses registros e a retenção personalizada, armazenando registros de execução no Cloud Logging.

Registros da Application Integration

Quando você executa uma integração, os registros de execução são gerados para ela e armazenados na região em que você a criou. É possível acessar esses registros para resolver erros e conferir o status de cada etapa de uma integração. A imagem a seguir mostra a página Registros de execução:

Para mais informações sobre como visualizar registros no Application Integration, consulte Registros de execução da integração.

Cloud Logging

O Cloud Logging é um sistema de gerenciamento de registros em tempo real com suporte para armazenamento, pesquisa, análise e monitoramento. Com a Application Integration, é possível aproveitar os recursos do Cloud Logging. Por padrão, o Cloud Logging está desativado para integrações. É possível ativar a geração de registros para uma integração editando a versão não publicada dela.

O Cloud Logging captura registros de tempo de execução da integração para os seguintes níveis de gravidade:

• Informações : registros que contêm registros de execução e outros detalhes relacionados a todas as execuções de integração: SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED e CANCELLED.
• Erro e aviso : registros que contêm registros de execução e outros detalhes relacionados aos estados de execução da integração FAILED e CANCELLED.

Para conferir uma lista de estados de execução de integração, consulte Estados de execução.

Para informações sobre como visualizar registros no Cloud Logging, consulte Visualizar registros de integração no Cloud Logging.

Para informações sobre como resolver problemas de registros de execução com falha usando a IA, consulte Resolver problemas de registros de execução com falha usando a IA.

Observação:o Cloud Logging só aceita entradas de registro de até 256 KiB. Se os registros excederem esse limite, os parâmetros de solicitação e resposta não serão mostrados nos detalhes do registro. Nesse caso, atualize as variáveis de integração para que o valor não exceda o limite. Como alternativa, veja esses registros no Application Integration.

Buckets de registros

Os registros de execução da integração são armazenados no bucket _Default com o local de armazenamento padrão configurado. É possível encaminhar registros para diferentes destinos:

• Envie registros para diferentes buckets de registros com locais de armazenamento diferentes usando filtros de inclusão e exclusão do Cloud Logging.
• Exporte os registros para destinos diferentes, como BigQuery ou Pub/Sub.

Para mais informações sobre roteamento e armazenamento do Cloud Logging, consulte Visão geral de roteamento e armazenamento.

Registros de auditoria

Para informações sobre registros de auditoria, consulte Ver registros de auditoria.

Preços

Os registros do Application Integration não têm custos extras, mas os registros de auditoria e o Cloud Logging têm modelos de preços diferentes. Para informações sobre os preços do Cloud Logging, consulte Preços do Cloud Logging.

Limitações

Os registros de integração estão sujeitos às seguintes limitações:

• O Cloud Logging só é compatível com entradas de registro de até 256 KiB. Se os registros excederem esse limite, os parâmetros de solicitação e resposta não serão mostrados nos detalhes do registro. Para informações sobre cotas e limites do Cloud Logging, consulte Cotas e limites. Para resolver esse erro, modifique o valor das variáveis de integração para que ele não exceda o limite. Como alternativa, você também pode ver esses registros na integração de aplicativos. Essa limitação se aplica aos registros do Cloud Logging.
• Se a geração de registros local estiver desativada, os registros de execução não serão enviados ao Cloud Logging, mesmo que ele esteja ativado. Essa limitação se aplica aos registros de execução da integração e aos registros do Cloud Logging.

A seguir

• Saiba como monitorar suas integrações usando o Cloud Monitoring.
• Saiba como criar alertas