Function Compute integra-se ao Simple Log Service. Após configurar o log de uma função, o Function Compute coleta logs automaticamente e os entrega a um Logstore no projeto especificado. Visualize logs por requisição, logs de instância e logs da função no console do Function Compute. Execute também consultas personalizadas de log no console do Simple Log Service.
Informações básicas
O Simple Log Service oferece coleta, armazenamento, consulta, análise, visualização e alertas de log. Para armazenar logs de funções, configure um projeto e um Logstore na função e conceda permissão de acesso ao Simple Log Service. Após a configuração, o sistema grava os logs da função no Logstore especificado.
Observações sobre faturamento
Método de faturamento
O Function Compute não cobra taxas adicionais pela ativação do recurso de log. No entanto, o Simple Log Service cobra pelos logs entregues.
Se o Logstore utilizar o método de faturamento por recurso, o Simple Log Service cobrará com base no espaço de armazenamento, tráfego de leitura, número de requisições, transformação de dados e envio de dados após a entrega dos logs pelo Function Compute. Para mais informações, consulte Itens de faturamento para o método de faturamento por recurso.
Caso o Logstore utilize o método de faturamento por dados ingeridos, o Simple Log Service cobrará com base nos dados brutos ingeridos após a entrega dos logs pelo Function Compute. Para mais informações, consulte Itens de faturamento para o método de faturamento por dados ingeridos.
Para alterar o método de faturamento do Logstore, consulte Gerenciar Logstores.
Parar o faturamento
Para interromper o faturamento, primeiro desative o recurso de log no console do Function Compute. Em seguida, acesse o console do Simple Log Service para excluir o Logstore ou excluir o projeto.
A exclusão de um projeto ou Logstore do Simple Log Service é irreversível. Após a exclusão, o sistema não pode mais entregar logs ao Simple Log Service e os dados existentes são excluídos permanentemente. Faça backup dos dados de log importantes antes de excluir.
Ativar log para uma função
Configurar log pelo console do Function Compute
Pré-requisitos
-
Function Compute
-
Opcional: Simple Log Service (SLS)
Procedimento
Faça login no console do Function Compute. No painel de navegação à esquerda, escolha .
Na barra de navegação superior, selecione uma região. Na página Functions, clique em a função desejada.
-
Na página de detalhes da função, selecione a aba Configuration, clique em Advanced Settings à direita de Advanced Settings, localize a opção Logs no painel Advanced Settings, conclua a configuração de log executando as etapas a seguir e clique em Deploy.
NotaAo criar uma função, o recurso de log é ativado por padrão e o sistema seleciona automaticamente o Log Service Project que começa com
serverless-<region_id>e o Logstore padrão.O console ativa automaticamente as Log Rotation Rules, as Request-level Metrics e as Instance-level Metrics, além de criar todos os índices necessários para consultas de log.
Item de configuração
Obrigatório
Descrição
Logging
Sim
Define se o Simple Log Service deve ser ativado. Valores válidos:
-
Enable: Ao ativar este recurso, o Function Compute importa logs para o seu projeto de log. Consulte e recupere logs no console do Function Compute e no console do Simple Log Service para solucionar problemas e identificar falhas.
-
Disable: Os logs da função não são persistidos, o que impede o rastreamento ou a localização de problemas.
Configuration Mode
Sim
Selecione Automatic Configuration ou Custom Configuration. Se escolher Custom Configuration, especifique um Log Service Project e um Logstore.
Log Service Project
Sim
Projeto destinado ao armazenamento de logs de invocação da função.
Logstore
Sim
Logstore utilizado para armazenar logs de invocação da função.
Log Rotation Rules
Não
Define se as regras de segmentação de log devem ser ativadas. Valores válidos:
-
Enable: Quando ativado, o Function Compute divide os logs conforme as regras de segmentação em múltiplos segmentos e os grava individualmente no Simple Log Service.
A regra padrão é
^.{0,2}\d{4}-\d{2}-\d{2}, que corresponde a datas no formatoxxxx-xx-xx, ondexé um dígito. O sistema divide os logs com base na presença de uma data no início da linha. Por exemplo, se uma linha de log começar com "2023-10-10", ela será tratada como a primeira linha de um novo bloco de log. Essa linha e as subsequentes sem data inicial são gravadas como uma única entrada de log. -
Disable: A segmentação de log fica desativada. Os logs são divididos usando o delimitador padrão
\n.
Request-level Metrics
Não
Define se os logs de métricas de requisição devem ser entregues ao Logstore. Recomendamos fortemente a ativação deste recurso.
Valores válidos:
-
Enable: Métricas de cada invocação da função — como tempo de execução, uso de memória, status de erro, ocorrência de cold start e duração das etapas de cold start — são entregues ao Logstore selecionado durante a configuração de log. Os logs de invocação do Function Compute exibem uma lista de requisições baseada nessas métricas. Filtre também requisições por métricas, como todas as requisições com erro ou requisições com cold start.
-
Disable: Não é possível visualizar informações detalhadas sobre a execução das requisições.
Instance-level Metrics
Não
Define se as métricas no nível de instância devem ser ativadas. Valores válidos:
-
Enable: Quando ativado, os dados de métrica das instâncias da função são entregues ao Logstore selecionado durante a configuração de log. Visualize métricas de desempenho no nível da instância da função, como uso de CPU, memória e E/S de rede. O Function Compute utiliza esses dados para fornecer observabilidade na granularidade da instância, oferecendo um caminho completo de monitoramento e solução de problemas para as instâncias da função. Para mais informações, consulte Métricas no nível de instância.
-
Disable: Não é possível visualizar métricas detalhadas da instância.
Configurar log usando o Serverless Devs
Pré-requisitos
Procedimento
-
Crie um diretório de código com a seguinte estrutura.
. ├── code │ └── index.js └── s.yamlNo exemplo, o campo logConfig configura o log. Substitua logstore e project por um Logstore e um projeto existentes na sua conta. Alternativamente, defina logConfig: auto para permitir que o Function Compute atribua automaticamente um projeto e um Logstore.
edition: 3.0.0 name: hello-world-app access: "default" vars: # Global variables region: "cn-hangzhou" resources: hello_world: component: fc3 # Component name props: region: ${vars.region} functionName: "start-nodejs-****" description: 'hello world by serverless devs' runtime: "nodejs16" code: ./code handler: index.handler memorySize: 128 timeout: 30 logConfig: # Replace logstore and project with actual values, or use logConfig: auto to auto-create project and Logstore enableInstanceMetrics: true # Enable instance-level metrics enableRequestMetrics: true # Enable request-level metrics logBeginRule: DefaultRegex # Log segmentation rule logstore: 'your-logstore' # Specify Logstore name (must exist) project: 'your-project' # Specify project name (must exist) -
Execute o comando a seguir para implantar o aplicativo.
sudo s deploy -yApós a implantação bem-sucedida, faça login no console do Function Compute para verificar se a função foi implantada e se o log está ativado.
Desativar log
Ao desativar o log, os logs de execução da função deixam de ser coletados ou armazenados. Isso pode afetar a solução de problemas e a análise de desempenho. Proceda com cautela.
Faça login no console do Function Compute. No painel de navegação à esquerda, escolha .
Na barra de navegação superior, selecione uma região. Na página Functions, clique em a função desejada.
Na página de detalhes da função, selecione a aba Configuration, clique em Modify à direita de Advanced Settings, no painel Advanced Settings, localize a opção Logs, defina o alternador log feature como Off e clique em Deploy.
Visualizar logs de invocação
Na página de detalhes da função, clique em a aba Logs para consultar os registros de invocação da função atual.
Na página de detalhes da função, clique em a aba Version Management ou Alias Management. Selecione uma versão ou alias da função e clique em a aba Logs na página de detalhes da versão ou alias para visualizar seus logs.
Visualize os logs de invocação da função na aba Invocation Requests ou na aba Search by Keyword. Diferenças:
-
Invocation Requests
Esta aba lista os horários de término da invocação da função, IDs de requisição, resultados da invocação, IDs de instância e versões ou aliases da função.
Clique em um Request ID para visualizar detalhes da requisição e do log.
Clique em um Instance ID para visualizar métricas da instância, como uso de CPU, uso de memória e tráfego de rede.
Na coluna Actions, clique em Request Logs para ver detalhes do log ou clique em Advanced Logs para acessar o console do Simple Log Service e realizar consultas e análises de log.
-
Search by Keyword
Esta aba lista os horários de invocação da função, o conteúdo do log e as versões ou aliases da função. Na coluna Actions, clique em Log Context para visualizar entradas de log adjacentes ou clique em Logstore para acessar o console do Simple Log Service e realizar consultas e análises de log.
Insira uma palavra-chave na caixa de pesquisa para encontrar logs específicos. Por exemplo, para localizar logs contendo o texto
hello world, digitehello worldna caixa de pesquisa. Os resultados incluirão todas as linhas de log contendo essa palavra-chave. Para mais informações sobre a sintaxe de consulta, consulte Sintaxe e recursos de consulta.
Referências
Configure também o log de uma função chamando o SDK ou a API. Para mais informações, consulte Criar uma função.