Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Collect container logs from an ACK Edge cluster

Última atualização: Sep 16, 2026

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

  1. Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.

  2. 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.

  3. 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.

  4. 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

  1. Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.

  2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Components and Add-ons .

  3. Na página Add-ons, clique na aba Logs and Monitoring e localize o componente logtail-ds.

    Nota
    • Nas 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-controller e logtail-ds-docker.

  4. 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.

  1. Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.

  2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Workloads > Deployments.

  3. Na página Deployments, selecione um namespace na lista suspensa Namespace na parte superior e clique em Create from Image no canto superior direito.

  4. 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.

  5. Na seção Log, configure as definições de log.

    1. Defina a Collection Configuration.

      Importante

      Nã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.

        Nota

        Por 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.

        Nota

        Se 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 access e catalina, respectivamente.

    2. 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 release e Tag Value como 1.0.0.

  6. 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.

  1. Acesse o console do Simple Log Service.

  2. Na seção Projects, selecione o Project do seu cluster Kubernetes (por padrão, k8s-log-{ClusterID}). Em seguida, acesse a aba Logstore.

  3. Localize o Logstore especificado na configuração de coleta. Na linha do Logstore, clique no ícone button 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