# Solução de problemas de execução e logs de funções Uma função criada com [Functions](/pt-br/documentacao/plataforma/functions/) pode falhar na instanciação, na invocação ou durante a execução. Sem saída de log, você não consegue dizer qual delas. Cada seção abaixo nomeia um sintoma, dá a sua causa e declara a correção. Comece pelos logs. --- ## Nenhuma saída de log de uma função Você chama `console.log` na função e nenhuma mensagem chega até você. Uma função escreve mensagens de log com `console.log`, do mesmo jeito que o JavaScript faz em um browser. A Azion coleta essa saída e a entrega em três lugares: [Azion CLI](/pt-br/documentacao/devtools/cli/), [Data Stream](/pt-br/documentacao/plataforma/data-stream/) e [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/). Até você abrir um deles, uma função que falha e uma função que nunca roda parecem iguais. Primeiro, confirme que o código registra alguma coisa. Este handler registra uma mensagem e retorna uma resposta: ```javascript export default { async fetch(request, env, ctx) { console.log('Hello World'); return new Response('Checking console output.', { status: 200 }); }, }; ``` Para ler a saída no terminal com Azion CLI: ```bash azion logs cells --tail ``` O terminal imprime as mensagens de console dos últimos 5 minutos e continua imprimindo as novas. Adicione `--function-id` para restringir a saída a uma função. O subcomando se chama `cells` porque uma função roda dentro de uma Cell, o ambiente de isolamento que a Azion constrói sobre isolates V8. Para enviar a mesma saída a um endpoint que você controla: 1. **Abra o Data Stream** Acesse [Azion Console](https://console.azion.com/) > **Data Stream**. 2. **Selecione + Stream** 3. **Digite um nome para o stream** 4. **Na seção Data Settings, defina Source como Functions** 5. **Defina Template como Functions Event Collector** 6. **Na seção Destination, mantenha Connector como Standard HTTP/HTTPS POST e digite a URL que recebe os dados** 7. **Selecione Save** O stream envia as mensagens de log das suas funções para essa URL. O template **Functions Event Collector** preenche a caixa **Data Set** com este preset: ```json { "time": "$time", "client": "$client", "configuration": "$global_id", "edgeFunctionID": "$edge_function_id", "requestID": "$request_id", "messageSource": "$message_source", "logLevel": "$log_level", "logMessage": "$log_message" } ``` | Variável | Definição | | ------------------- | ------------------------------------------------------- | | `$time` | Data e hora da requisição. | | `$client` | Identificador único do cliente Azion. | | `$global_id` | Identificação das configurações. | | `$edge_function_id` | Identificador da função. | | `$request_id` | Identificador da requisição. | | `$message_source` | A origem da mensagem. | | `$log_level` | Nível do log criado: ERROR, WARN, INFO, DEBUG ou TRACE. | | `$log_message` | Mensagem usada no log quando a função é requisitada. | Para ler a mesma saída em Azion Console: 1. **Abra o Real-Time Events** Acesse [Azion Console](https://console.azion.com/) > **Real-Time Events**. 2. **Selecione a aba Functions Console** 3. **Use os filtros para restringir a consulta** 4. **(Opcional) Selecione a aba Data Stream para ver os registros enviados aos seus endpoints** 5. **Selecione um item para ver os seus detalhes** A aba **Functions Console** lista uma entrada por mensagem de log, com o seu nível, a sua linha e o identificador da requisição que a produziu. --- ## A função nunca roda A função existe em **Functions** e nenhuma requisição a executa. Nada das suas chamadas de `console.log` chega aos logs da função. Criar uma função não a executa. Uma função roda quando uma aplicação a instancia e uma regra do [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) seleciona essa instância pelo comportamento **Run Function**. Sem os dois, o código nunca é executado. Verifique a cadeia nesta ordem: - **Módulo Functions**: na aba **Main Settings** da aplicação, ative **Functions** e selecione **Save**. - **Instância de função**: na aba **Functions Instances**, selecione **+ Function Instance**, selecione a sua função e defina os seus **Args**. A instância vincula a função à aplicação e carrega os argumentos JSON passados para o contexto de execução dela. Consulte [Instâncias de função](/pt-br/documentacao/plataforma/applications/functions-instances/). - **Regra Run Function**: na aba **Rules Engine**, adicione uma regra, defina os seus critérios e selecione o comportamento **Run Function** com a sua instância. - **Critérios da regra**: uma regra executa os seus comportamentos apenas quando a requisição atende aos seus critérios. Compare os critérios com a URI que você requisita. - **Ordem dos comportamentos**: **Deliver**, **Deny (403 Forbidden)** e **Finish Request Phase** encerram o processamento de uma requisição. Um **Run Function** posicionado depois de um deles nunca é executado. Mova-o para cima do comportamento que encerra a requisição. A próxima requisição que atende aos critérios executa a função, e as suas mensagens chegam aos logs da função. --- ## Run Function não aparece na lista de comportamentos Você adiciona uma regra na aba **Rules Engine** de uma aplicação e **Run Function** não está entre os comportamentos. O comportamento **Run Function** depende de dois módulos: [Application Accelerator](/pt-br/documentacao/plataforma/applications/#application-accelerator) e **Functions**. Enquanto Application Accelerator estiver desativado, Rules Engine oferece apenas parte das suas variáveis e dos seus comportamentos. Para ativar os dois módulos: 1. **Abra a sua aplicação** Acesse [Azion Console](https://console.azion.com/) > **Applications** > a sua aplicação. 2. **Na aba Main Settings, na seção Modules, ative Application Accelerator** 3. **Ative Functions** 4. **Selecione Save** **Run Function** aparece na lista de comportamentos de uma regra, na fase de requisição e na fase de resposta. --- ## A função falha na instanciação A instância de função carrega um objeto **Args** grande, e a função falha na instanciação. **Args** é o objeto JSON que uma instância de função passa para o contexto de execução da função. O campo aceita no máximo 100 KB. Argumentos acima desse tamanho fazem a função falhar na instanciação. - **Reduza o objeto Args**: diminua o JSON até que ele fique abaixo de 100 KB. - **Solicite um limite maior**: os 100 KB são um default. Para aumentá-lo no seu plano, entre em contato com o [suporte técnico](/pt-br/documentacao/suporte/). Com os argumentos abaixo de 100 KB, a instância é salva e a função recebe o objeto no seu contexto de execução. --- ## A função para antes de retornar uma resposta A função inicia e a invocação termina antes de o código retornar a sua resposta. Uma invocação roda dentro de três tetos, e um quarto limita o contexto de execução que a carrega: - **Tempo de execução de CPU, 2 s**: o tempo máximo de CPU por invocação. Ele mede a computação ativa, não o tempo de relógio, então o tempo gasto esperando por `fetch()` não conta. Uma função que o excede é encerrada. - **Tempo de execução, 5 min**: o tempo máximo de relógio para uma invocação, incluindo espera de I/O, chamadas `fetch()` e operações assíncronas. - **Sub-requisições, 50**: o número máximo de chamadas `fetch()` de saída em uma invocação. - **Memória por isolate, 512 MB**: a memória máxima para um único contexto de execução (isolate V8), incluindo heap, stack e todas as alocações do runtime. Reduza o trabalho que a invocação realiza: - **Encontre onde está a pressão**: uma função que passa a execução esperando por uma origem fica longe do teto de CPU, por mais longa que seja a requisição. Uma função que analisa ou transforma um corpo grande a cada requisição gasta esse orçamento. - **Tire o trabalho do caminho da resposta**: o trabalho de que a resposta não precisa é entregue a `ctx.waitUntil()`, que estende a duração da função para além da resposta. Isso tira o trabalho do caminho da resposta sem tirá-lo da invocação. O tempo de relógio de 5 minutos continua a delimitá-lo. - **Consolide as chamadas de saída**: um design cuja contagem de chamadas cresce com a entrada, uma requisição por item de uma lista, ultrapassa o teto de sub-requisições assim que a lista passa de 50 itens. Substitua uma chamada por membro por uma chamada que retorna o conjunto. Essa troca tem o seu próprio limite: o corpo que uma função pode processar é limitado por plano, em 100 MB no Hobby, 200 MB no Pro e 500 MB no Enterprise. - **Solicite um limite maior**: todo teto é um default. Para aumentar um deles no seu plano, entre em contato com o [suporte técnico](/pt-br/documentacao/suporte/). Para o conjunto completo, consulte [Limites](/pt-br/documentacao/plataforma/functions/limites/). Uma função cujo trabalho cabe dentro dos tetos de CPU e de tempo de relógio roda até o fim e retorna a sua resposta. --- ## Entradas `ERROR` nos logs da função Os logs da função carregam entradas cujo nível é `ERROR`, como `TypeError: Object not found`. Toda entrada de log carrega um nível e uma origem de linha. `CONSOLE` marca uma linha que o seu próprio código escreveu com `console.log`. `RUNTIME` marca uma linha que Azion Runtime produziu, como uma exceção levantada enquanto a função era executada. - **Leia a requisição inteira**: o identificador da requisição agrega todas as mensagens de uma mesma requisição. Filtre por ele para ver o que a função registrou antes do erro. - **Consulte os eventos**: a query `functionConsoleEvents` retorna `level`, `lineSource` e `line` para um intervalo de tempo. Consulte [Consulte logs de funções com GraphQL API](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/functions-e-runtime/debugging-functions-graphql/). - **Filtre em Azion Console**: a aba **Functions Console** de [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/) mostra os mesmos campos com filtros. Agora você tem a mensagem da exceção e o identificador da requisição que a produziu. --- ## O preview não renderiza nada Você abre [Preview deployment](/pt-br/documentacao/plataforma/functions/preview-deployment/) para uma função e nenhuma resposta aparece ao lado do editor de código. O preview mostra um aviso que nomeia a função ausente. Preview deployment renderiza o resultado de uma função auxiliar no seu código-fonte, chamada `PreviewProvider`. Essa função monta uma requisição simulada e entrega o resultado ao preview. Sem `PreviewProvider`, o preview não tem nada para renderizar. - **Adicione a função `PreviewProvider`**: ela cria a requisição que o preview envia ao seu handler. Consulte [Preview deployment](/pt-br/documentacao/plataforma/functions/preview-deployment/). - **Depure a função em execução com `inspect`**: a ferramenta `inspect` dentro de Preview deployment mostra o comportamento da função em tempo real. O preview renderiza a resposta ao lado do editor de código, e o botão **open** a mostra em uma aba separada. --- ## Recursos relacionados - [Preview deployment](/pt-br/documentacao/plataforma/functions/preview-deployment.md): Reproduza a resposta no Azion Console antes que a função atenda tráfego. - [Instâncias de função](/pt-br/documentacao/plataforma/applications/functions-instances.md): Como uma instância vincula uma função a uma aplicação e carrega os seus Args. - [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine.md): As fases de processamento, os critérios e o comportamento Run Function. - [Faça o debug de functions no Data Stream](/pt-br/documentacao/guias/plataforma/observabilidade/debugging-functions-data-stream.md): A configuração completa do stream, incluindo a associação com o workload. - [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events.md): Os campos da fonte de dados Functions Console. - [Logs do Azion CLI](/pt-br/documentacao/devtools/cli/logs.md): As flags do comando `azion logs cells`.