O ACK Edge integra-se ao Simple Log Service para coletar logs de contêineres em clusters de borda. Este tópico descreve como ativar o agente de coleta de logs, configurar quais logs coletar por workload e verifique se os logs estão visíveis no Simple Log Service.
Tipos de log coletados: saída padrão do contêiner (stdout/stderr) e arquivos de texto nos contêineres.
Pré-requisitos
Antes de começar, verifique se você tem:
Um cluster ACK Edge (consulte Criar um cluster ACK Edge)
Um projeto do Simple Log Service ou permissão para criá-lo automaticamente durante a configuração do cluster
Padrões de coleta
|
Configuração |
Padrão |
|
Modo de coleta |
Modo simples (linha por linha) |
|
Período de retenção de logs |
180 dias |
|
Criação de Logstore |
Criado automaticamente no projeto associado ao cluster, caso ainda não exista |
Etapa 1: Ative o componente Logtail
Ative o agente de coleta de logs Logtail ao criar um cluster ou adicione-o a um cluster existente.
Ative o Logtail durante a criação do cluster
Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique em Create Kubernetes Cluster. Esta seção aborda apenas as etapas relacionadas a logs. Para o procedimento completo de criação de cluster, consulte Criar um cluster ACK Edge.
-
Na etapa Component Configurations, selecione Enable Log Service. Após selecionar Enable Log Service, associe um projeto para gerencie os logs coletados. Para entender como o Simple Log Service organiza os logs, consulte Projetos. Duas opções estão disponíveis:
Clique em Select Project para usar um projeto existente.

Clique em Create Project para crie automaticamente um projeto chamado
k8s-log-{ClusterID}, onde{ClusterID}é o ID exclusivo do novo cluster.
Clique em Create Cluster no canto inferior direito. Na caixa de diálogo exibida, clique em OK. Após a criação, o cluster aparece na página Clusters com o Logtail ativado.
Ative o Logtail em um cluster existente
O nome do componente de log depende da versão do cluster:
Versão posterior a 1.18.8-aliyunedge.1: logtail-ds
Versão 1.18.8-aliyunedge.1 ou anterior: alibaba-log-controller e logtail-ds-docker
Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique no nome do cluster que deseja gerencie. No painel de navegação à esquerda, clique em Add-ons.
Na página Add-ons, clique na aba Logs and Monitoring e localize o componente logtail-ds.
Clique em Install. Na caixa de diálogo Install logtail-ds, clique em OK. Se uma versão anterior do componente de log estiver instalada, clique em Upgrade.
Etapa 2: Configure a coleta de logs para uma aplicação
Não é possível modificar uma configuração de coleta de logs após sua criação. Para alterar uma configuração existente, use um CRD — consulte Usar um CRD para coletar logs de contêineres no modo DaemonSet.
Configure a coleta de logs ao criar um novo workload de aplicação.
Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, escolha Workloads > Deployments.
Na página Deployments, selecione um namespace na lista suspensa Namespace e clique em Create from Image no canto superior direito.
Na aba Basic Information, defina Name, Replicas e Type. Clique em Next para acesse a página Container. Esta seção aborda apenas as configurações relacionadas a logs. Para todas as outras configurações da aplicação, consulte Criar um workload sem estado (Deployment).
-
Na seção Log, configure os seguintes itens: Collection Configuration Clique em Collection Configuration. Cada configuração mapeia um Logstore para um caminho de log no contêiner. Por padrão, os logs são coletados no modo simples (linha por linha). Para modo multilinha ou métodos avançados de coleta, consulte Coletar logs de texto de contêineres no modo DaemonSet usando o console e Coletar saída padrão de contêineres no modo DaemonSet usando o console. Custom Tag Clique em Custom Tag para adicionar pares chave-valor aos logs coletados. As tags personalizadas permitem rotular dados de log com metadados do contêiner, como um número de versão.
Logstore: Nome do Logstore onde os logs coletados são armazenados. Se o Logstore não existir, o ACK o cria automaticamente no projeto do Simple Log Service associado ao cluster.
Log Path in Container: Caminho dos logs a serem coletados. Por exemplo,
/usr/local/tomcat/logs/catalina.*.logcoleta logs de texto do Tomcat. Defina comostdoutpara coletar a saída padrão (stdout) e o erro padrão (stderr).


Clique em Next no canto superior direito para continuar. Para as etapas subsequentes de configuração, consulte Criar um workload sem estado (Deployment).
Etapa 3: Visualize logs
Após concluir a configuração, os logs são coletados e armazenados no Simple Log Service. O exemplo a seguir mostra como visualize logs de uma aplicação Tomcat criada pelo console.
Acesse o console do Simple Log Service.
Na seção Projects, selecione o projeto associado ao seu cluster. O nome padrão do projeto é
k8s-log-{ClusterID}. Em seguida, clique na aba Logstores.Localize o Logstore especificado na configuração de coleta. Passe o ponteiro sobre o lado direito do nome do Logstore, clique no ícone
e clique em Search & Analysis. A página de consulta de logs exibe os logs de saída padrão e os logs de texto dentro do contêiner da aplicação. As tags personalizadas aparecem como campos adicionais nos logs.
Próximos passos
Se algo deu errado:
Perguntas frequentes sobre Logstore — aborda alteração do período de retenção de logs, desativação da coleta de logs e operações semelhantes
Para coletar mais tipos de log:
Coletar logs de texto de contêineres Kubernetes usando sidecar
Coletar saída padrão de contêineres Kubernetes no modo DaemonSet (legado)
Para expandir ou gerencie sua configuração:
Gerenciar regras de alerta — adicione regras de alerta para logs e monitore o status do cluster
Usar o Logtail para coletar logs de contêineres entre contas Alibaba Cloud