Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Use Simple Log Service to collect container logs from ACK Edge clusters

Última atualização: Jun 27, 2026

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

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

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

  3. 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. 使用已有Project

    • Clique em Create Project para crie automaticamente um projeto chamado k8s-log-{ClusterID}, onde {ClusterID} é o ID exclusivo do novo cluster. 创建新Project

  4. 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
  1. Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.

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

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

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

Importante

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.

  1. Faça login no console 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, escolha Workloads > Deployments.

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

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

  5. 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.*.log coleta logs de texto do Tomcat. Defina como stdout para coletar a saída padrão (stdout) e o erro padrão (stderr).

    采集配置

    自定义tag

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

  1. Acesse o console do Simple Log Service.

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

  3. Localize o Logstore especificado na configuração de coleta. Passe o ponteiro sobre o lado direito do nome do Logstore, clique no ícone button 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:

Para coletar mais tipos de log:

Para expandir ou gerencie sua configuração: