Todos os produtos
Search
Central de documentação

Simple Log Service:Use CRs para gerencie configurações do Logtail

Última atualização: Oct 14, 2026

O Simple Log Service define dois CRDs do Kubernetes, AliyunPipelineConfig e AliyunLogConfig, que permitem gerencie configurações do Logtail como CustomResources (CRs).

Visão geral

Um CRD estende a API do Kubernetes para definir tipos de recursos personalizados. Cada CR é uma instância de um CRD. Estenda a API do Kubernetes com CustomResourceDefinitions.

Para gerencie as configurações do Logtail com CRs, conecte-se ao seu cluster Kubernetes, autentique-se e envie um arquivo YAML ao kube-apiserver para crie um CR.

Aviso

Se você crie uma configuração do Logtail por meio de um CR, atualize-a sempre pelo próprio CR. As alterações feitas no console do SLS não são sincronizadas com o CR.

Implementação do gerenciamento de configurações do Logtail com base em CRs

image
  1. O SLS cria um Deployment para instalar o alibaba-log-controller, componente que monitora as alterações no CRD AliyunLogConfig.

  2. Ao crie, atualize ou exclua um CR AliyunLogConfig por meio do kubectl ou de outras ferramentas, o alibaba-log-controller detecta a alteração e envia a solicitação correspondente ao SLS (por exemplo, para atualize a configuração do Logtail).

CRDs

O SLS disponibiliza dois CRDs para gerencie configurações do Logtail no Kubernetes: AliyunPipelineConfig e AliyunLogConfig. A tabela a seguir compara as funcionalidades de cada um.

Importante

O AliyunPipelineConfig exige a versão 0.5.1 ou superior do Logtail.

CRD

AliyunPipelineConfig (recomendado)

AliyunLogConfig

ApiGroup

telemetry.alibabacloud.com/v1alpha1

log.alibabacloud.com/v1alpha1

Nome do recurso do CRD

ClusterAliyunPipelineConfig

AliyunLogConfig

Escopo

Cluster

Namespace

Formato de configuração do Logtail

Equivalente a LogtailPipelineConfig

Equivalente a LogtailConfig

Operação entre regiões

Suportado

Suportado

Operação entre contas

Suportado

Suportado

Verificação de parâmetros relacionados a webhooks

Suportado

Não suportado

Detecção de conflitos de configuração

Suportado

Suportado (Logtail 0.5+)

Complexidade da configuração

Relativamente baixa

Relativamente alta

Configuração de observabilidade

O campo Status inclui detalhes do erro, horário da atualização, a configuração do Logtail aplicada anteriormente e o momento da aplicação.

O campo Status contém o código e a mensagem de erro.