O Alibaba Cloud ACK Edge integra-se ao Simple Log Service. Ao criar um cluster ACK Edge, ative o Simple Log Service para coletar rapidamente os logs de contêiner do cluster, incluindo saída padrão e arquivos de texto.
Etapa 1: Ativar o componente Logtail
Ative o componente Logtail durante a criação de um cluster ACK Edge selecionando Enable Log Service. Também é possível ativar o componente em um cluster ACK Edge existente.
Ativar o Logtail durante a criação do cluster
Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.
-
Na página Clusters, clique em Create Kubernetes Cluster.
As etapas a seguir descrevem apenas como ativar o Simple Log Service. Para obter mais informações sobre a criação de clusters, consulte Create an ACK Edge cluster.
-
No assistente de Component Configurations, selecione Enable Log Service.
Ao selecionar Enable Log Service, o sistema solicitará a criação de um Project. Para saber mais sobre a organização de logs pelo Simple Log Service, consulte Project. Crie um Project das seguintes formas:
Clique em Select Project e selecione um Project existente para gerenciar os logs coletados.
Clique em Create Project. O sistema criará automaticamente um novo Project para gerenciar os logs coletados. O nome do Project seguirá o padrão
k8s-log-{ClusterID}, onde {ClusterID} é o ID exclusivo do novo cluster ACK Edge.
-
Após concluir as configurações, clique em Create Cluster no canto inferior direito e, em seguida, clique em Confirm na caixa de diálogo.
Após a criação, o cluster ACK Edge com o Logtail ativado aparecerá na página Clusters.
Ativar o Logtail em um cluster existente
Faça login no console do 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, clique em Components and Add-ons .
-
Na página Add-ons, clique na aba Logs and Monitoring e localize o componente logtail-ds.
NotaNas versões do ACK Edge posteriores a 1.18.8-aliyunedge.1, os componentes de log foram unificados no
logtail-ds.Nas versões 1.18.8-aliyunedge.1 e anteriores do ACK Edge, os componentes de log consistem em
alibaba-log-controllerelogtail-ds-docker.
-
Na linha do componente logtail-ds, clique em Install. Na caixa de diálogo Install Comment, clique em OK.
Se houver uma versão anterior do componente Simple Log Service instalada, clique em Upgrade no lado direito do componente.
Etapa 2: Configurar o Simple Log Service para aplicações
Configure o Simple Log Service durante a criação de uma aplicação para coletar logs do cluster ACK Edge.
Faça login no console do 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, clique em .
Na página Deployments, selecione um namespace na lista suspensa Namespace na parte superior e clique em Create from Image no canto superior direito.
-
Na aba Basic Information, defina o Name, as Replicas: e o Type. Em seguida, clique em Next para acessar a página Container.
Esta seção descreve apenas as configurações relacionadas ao Simple Log Service. Para obter informações sobre outras configurações da aplicação, consulte Create a stateless Deployment.
-
Na seção Log, configure as definições de log.
-
Defina a Collection Configuration.
ImportanteNão é possível modificar as configurações de coleta de log após a criação. Para fazer alterações, consulte Collect container logs by using a DaemonSet-CRD.
Clique em Collection Configuration. Cada configuração de coleta consiste em um Logstore e um Log Path in Container.
-
Logstore: Especifique um nome para o Logstore onde os logs coletados serão armazenados. Se o Logstore especificado não existir, o ACK o criará automaticamente no Project do Simple Log Service associado ao cluster.
NotaPor padrão, os logs em um Logstore recém-criado são retidos por 180 dias.
-
Log Path in Container: Especifique o caminho dos logs que deseja coletar. Por exemplo, use /usr/local/tomcat/logs/catalina.*.log para coletar logs de texto do Tomcat.
NotaSe você especificar
stdout, o Logtail coletará a saída padrão (stdout) e o erro padrão (stderr) do contêiner.Cada configuração de coleta é criada automaticamente para o Logstore correspondente, usando o modo simples (coleta linha a linha) por padrão. Para o modo multilinha e métodos de coleta mais avançados, consulte Collect container text logs in DaemonSet mode by using the console e Collect container standard output in DaemonSet mode by using the console.
Antes de prosseguir, certifique-se de que o plug-in de log esteja implantado no cluster. Por exemplo, defina os campos Logstore como
accessecatalina, respectivamente. -
-
Defina as Custom Tag s.
Clique em Custom Tag. Cada tag personalizada é um par chave-valor anexado aos logs coletados. Use essas tags para rotular os dados de log de um contêiner com informações como número de versão.
Por exemplo, defina Tag Name como
releasee Tag Value como1.0.0.
-
-
Após concluir todas as configurações, clique em Next no canto superior direito para continuar.
Para obter informações sobre as etapas subsequentes, consulte Create a stateless Deployment.
Etapa 3: Visualizar logs
Após configurar a coleta de logs para a aplicação Tomcat, os logs serão armazenados no Simple Log Service. Em seguida, visualize os logs do contêiner no console do Simple Log Service.
Acesse o console do Simple Log Service.
Na seção Projects, selecione o Project do seu cluster Kubernetes (por padrão,
k8s-log-{ClusterID}). Em seguida, acesse a aba Logstore.-
Localize o Logstore especificado na configuração de coleta. Na linha do Logstore, clique no ícone
e selecione Query and Analysis.Na página de consulta de logs, visualize a saída padrão da aplicação e os logs de texto dentro do contêiner. As tags personalizadas adicionadas também aparecem anexadas aos campos de log.
Documentos relacionados
Para coletar logs de texto de contêiner usando um sidecar, consulte Collect Kubernetes container text logs in sidecar mode.
Para coletar a saída padrão de contêineres Kubernetes, consulte Collect the standard output of Kubernetes containers in DaemonSet mode (legacy).
Monitore o status de execução do seu cluster adicionando regras de alerta aos logs. Para obter mais informações, consulte Manage alert monitoring rules.
Para informações sobre solução de problemas, consulte Troubleshoot Logtail log collection failures.
Para coletar logs de contêiner entre contas Alibaba Cloud, consulte Use Logtail to collect container logs across Alibaba Cloud accounts.
Para questões relacionadas a um Logstore do Simple Log Service, como alterar o período de retenção de logs ou desativar a coleta de logs, consulte Troubleshoot Logstore-related issues.