Container Service for Kubernetes:Configure o Simple Log Service

Como funciona

Ao criar um cluster de workflow, o sistema cria um projeto do SLS chamado k8s-log-<clusterid>. Todos os logs dos pods são coletados em um Logstore denominado workflow-logstore.

Após ativar esse recurso, visualize logs pela CLI do Argo, pelo Argo Server ou pela interface do Argo, independentemente de o pod ainda estar em execução.

Limitações

• Se o oss-artifact-repository estiver ativado com archiveLogs: true, os logs serão armazenados no repositório de artefatos e a coleta de logs do SLS não terá efeito.

• Em comparação ao oss-artifact-repository, o SLS oferece gerenciamento automático do ciclo de vida dos logs, com dias de retenção configuráveis e recursos avançados de consulta. Para coletar logs usando o SLS, remova a configuração archiveLogs: true.

• Com a coleta de logs ativada, os logs dos pods de workflow ficam disponíveis na CLI do Argo e na interface do Argo enquanto o workflow estiver no cluster, mesmo que um pod seja excluído.

• Caso o workflow esteja persistido em um banco de dados, baixe seus logs como um arquivo ZIP ou visualize-os no console do SLS mesmo após a exclusão do workflow. Consulte Persist workflows.

Ative o SLS

Se o projeto k8s-log-<clusterid> não foi criado automaticamente, crie-o manualmente. Consulte Create an SLS project.

Escolha um dos métodos abaixo:

argo config sls
Please input log retention days. Default is 7 days.
10

Start to config SLS for your cluster.
Created AliyunLogConfig CR workflow-sls-config in default namespace.
Created SLS logstore workflow-logstore in SLS project k8s-log-<clusterid>, log retention days is 10 days

cat << EOF | kubectl apply -f -
apiVersion: log.alibabacloud.com/v1alpha1
kind: AliyunLogConfig
metadata:
  name: workflow-sls-config
  namespace: default
spec:
  lifeCycle: 5           # Log retention period in days
  logstore: workflow-logstore
  logtailConfig:
    configName: workflow-sls-config
    inputType: plugin    # Use the plugin-based input method
    inputDetail:
      plugin:
        inputs:
        - type: service_docker_stdout  # Collect container stdout and stderr
          detail:
            Stdout: true
            Stderr: true
EOF

Verifique a coleta de logs

Após ativar o SLS, confirme se os logs estão sendo coletados:

1. Faça login no console do SLS.

2. Localize o projeto k8s-log-<clusterid>.

3. Clique em workflow-logstore e verifique se as entradas de log aparecem.

Se nenhum log aparecer, verifique se o recurso personalizado AliyunLogConfig foi criado:

kubectl get aliyunlogconfigs -n default

A saída deve incluir workflow-sls-config sem status de erro. Se o recurso estiver ausente ou com erro, execute novamente as etapas de ativação ou verifique as permissões do usuário RAM.

Acessar logs com a Argo CLI

A Alibaba Cloud Argo CLI oferece duas formas de visualizar logs de workflow. O método direto (flag --sls) é recomendado, pois não exige o Argo Server.

Execute kubectl logs <pod-name> para visualizar logs de um pod existente. Esse comando retorna até 2.000 linhas por padrão. Para visualizar mais logs ou logs de um pod excluído, use um dos métodos a seguir.

Visualize logs de workflows persistidos em bancos de dados

Se um workflow estiver persistido em um banco de dados, baixe seus logs mesmo após a exclusão do workflow.

1. Conceda acesso da Argo CLI ao seu cluster:

   argo config init  # Follow the prompts to enter your AccessKey ID and AccessKey secret.

2. Obtenha o UID do workflow arquivado:

   argo archive list

   Saída esperada:

   NAMESPACE   NAME                   STATUS      AGE   DURATION   PRIORITY   MESSAGE   P/R/C   PARAMETERS   UID
   default     hello-world-l6c2r      Succeeded   3d    1m         0                    0/0/0                179eaef0-fde3-496f-946d-549e8f******

3. Baixe os logs do workflow usando o UID:

   argo archive logs 179eaef0-fde3-496f-946d-549e8f******

   Os logs são salvos como <workflow-name>.zip no diretório atual.

Visualize logs na interface do Argo

A interface do Argo exibe diretamente os logs dos pods de workflow. Se um pod for excluído, os logs do SLS serão mostrados no lugar da saída ao vivo do pod.

Desativar o SLS

1. Exclua o recurso personalizado AliyunLogConfig:

   kubectl delete aliyunlogconfigs.log.alibabacloud.com workflow-sls-config -n default

2. Faça login no console do SLS e exclua o Logstore workflow-logstore.

Próximas etapas

• Persist workflows — Armazene o estado do workflow em um banco de dados para manter logs e resultados após a exclusão.

• Alibaba Cloud Argo CLI — Baixe e configure a CLI para acesso completo aos logs.