Ver os logs das Funções de Dados do Utilizador

Os registos ajudam-no a perceber como as suas Funções de Dados de Utilizador estão a executar e a diagnosticar problemas quando as funções não se comportam como esperado. Pode visualizar os registos de duas formas:

• Durante os testes - Visualize registos em tempo real no painel de Teste ao testar funções em modo Desenvolvimento
• Após a invocação - Consulte os registos históricos das funções publicadas que foram invocadas

Este artigo explica como visualizar e usar registos para monitorizar a execução de funções e resolver problemas.

Ver registos durante os testes

Quando testa funções, pode ver logs em tempo real enquanto a sua função é executada:

• Painel de testes em modo Desenvolvimento - Ver registos ao testar funções não publicadas ou publicadas
• Painel de execução em modo de execução exclusivo - Visualize os registos ao executar funções publicadas

Ambos os painéis mostram imediatamente a saída dos logs, permitindo-lhe ver detalhes de execução e problemas de depuração à medida que ocorrem. Para mais informações sobre funções de teste, consulte Teste as suas Funções de Dados de Utilizador.

Consulte registos históricos para funções invocadas

Depois de as suas funções publicadas terem sido invocadas, pode consultar registos históricos para analisar execuções passadas.

Para aceder aos registos históricos:

1. Muda para modo apenas Run usando o comutador de modos.

2. Passe o rato sobre o nome da função na lista de funções.

3. Selecione o ícone das elipses (...), depois selecione Ver registo histórico.

   

Compreenda a visualização dos registos históricos

A vista dos registos históricos mostra invocações recentes para a função selecionada. Pode ver até 50 entradas, e os registos são mantidos durante 30 dias. Selecione o link de data na coluna Data (UTC) para visualizar registos detalhados de uma invocação específica.

O painel de todos os registos históricos contém a seguinte informação por invocação:

• Data (UTC). A marca temporal mostrando o início da invocação da função. Selecione o link para revisar todos os logs dessa invocação. Ele exibe os detalhes da invocação com todas as mensagens registradas pelo usuário ou serviço.
• Estado. Indica se a invocação foi bem-sucedida ou falhou.
• Duração (ms). A duração da execução da função em milissegundos.
• ID de invocação. A ID dessa invocação de função específica. A ID de invocação é retornada como parte de um cabeçalho HTTP. Se houver algum problema, os usuários podem fazer referência a essa ID de invocação em uma solicitação de suporte para recuperar mais informações sobre a invocação.

Consulte registos detalhados para uma invocação específica

Depois de abrires a vista dos registos históricos (como descrito na secção anterior), podes aprofundar as invocações individuais. Quando seleciona um link de carimbo temporal na coluna Data (UTC ), abre-se o painel de detalhes da invocação para mostrar todos os registos dessa invocação. Pode ver:

• Todos os logs adicionados no seu código de função usando o módulo logging
• Registos gerados pelo sistema sobre execução de funções
• Quaisquer erros ou exceções que tenham ocorrido

Cada entrada do registo inclui o carimbo temporal, a mensagem do registo e o nível do registo (Informação, Aviso, Erro, Crítico).

Captura de ecrã mostrando como exibir logs detalhados para uma determinada chamada de função.

Adicionar registo às suas funções

Podes adicionar instruções de registo personalizadas às tuas funções usando o módulo padrão logging do Python. Os registos ajudam a acompanhar o comportamento das funções, monitorizar o processamento de dados e diagnosticar problemas.

Importar o módulo de registo

Primeiro, importa o logging módulo no teu código de função:

import logging

Utilizar níveis de registo apropriados

O Python fornece diferentes níveis de log para diferentes situações. Use o nível adequado para tornar os seus registos mais significativos:

# INFO - Track normal function execution and key steps
logging.info('Processing started for customer ID: 12345')
logging.info('Successfully retrieved 150 records from database')

# WARNING - Log potentially problematic situations that don't prevent execution
logging.warning('API response time exceeded 2 seconds')
logging.warning('Using cached data because fresh data is unavailable')

# ERROR - Log errors that affect functionality but don't crash the function
logging.error('Failed to connect to external API: Connection timeout')
logging.error('Invalid data format in row 42')

# CRITICAL - Log severe errors that may cause function failure
logging.critical('Database connection lost')
logging.critical('Required configuration parameter missing')

Melhores práticas para a exploração de madeira

Siga estas práticas para tornar os seus registos mais eficazes:

• Registar informações significativas - Incluir detalhes relevantes como IDs, contagens ou valores de parâmetros que ajudem a diagnosticar problemas
• Use níveis de registo apropriados - Não registre tudo como INFO ou ERRO; Use o nível certo para a situação
• Registo em pontos-chave - Adicione registos no início das funções, antes e depois de chamadas externas, e ao processar dados
• Evite registar dados sensíveis - Não registre palavras-passe, tokens, informações pessoais ou outros dados sensíveis
• Mantenha as mensagens concisas - Escreva mensagens de registo claras e breves que sejam fáceis de analisar
• Esteja atento ao volume - O excesso de registo pode afetar o desempenho e ultrapassar o limite diário de ingestão

Para mais informações sobre como escrever código de funções, consulte o modelo de programação em Python.

Limitações e retenção de registos

Tenha em mente as seguintes limitações ao trabalhar com registos:

• Retenção de registos - Registos históricos de invocação são mantidos por padrão durante 30 dias
• Entradas visíveis - A vista dos registos históricos mostra até 50 entradas por função
• Disponibilidade de registos - Os registos de invocação podem demorar alguns minutos a aparecer; Atualize a página se não vir registos recentes
• Limite diário de ingestão - 250 MB por dia; O limite reinicia-se diariamente
• Amostragem - Os registos podem ser amostrados para reduzir o volume, preservando a análise estatisticamente correta
• Tipos de registo suportados - Informação, Erro, Aviso e Rastreio

Para informações completas sobre limites de serviço, consulte Detalhes e limitações do Serviço.

Conteúdo relacionado

• Teste as suas Funções de Dados de Utilizador - Aprenda a testar funções e a visualizar registos em tempo real no painel de Testes
• Modelo de programação em Python - Compreender como escrever código de funções e usar o módulo de registo
• Detalhes e limitações do serviço - Rever a retenção dos registos e os limites do serviço
• Tutorial: Invocar funções de dados de utilizador a partir de uma aplicação Python - Aprenda a invocar funções e a usar IDs de invocação