Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:AliyunLogConfig kullanarak Logtail yapılandırmasını yönetin

Son Güncelleme:Sep 30, 2026

AliyunLogConfig, Simple Log Service tarafından tanımlanan bir Özel Kaynak Tanımıdır (CRD). Bu CRD'den bir YAML dosyasında özel kaynak (CR) oluşturarak Kubernetes kümesinde Logtail yapılandırmalarını bildirimsel olarak oluşturabilir, görüntüleyebilir, güncelleyebilir ve silebilirsiniz.

Ön koşullar

Sınırlamalar

AliyunLogConfig kullanarak Logtail yapılandırmasını yönetirken aşağıdaki sınırlamalar geçerlidir:

  • Konsol değişiklikleri senkronize edilmez — Bir Logtail yapılandırmasını AliyunLogConfig CR ile oluşturduysanız Simple Log Service konsolunda yaptığınız değişiklikler CR'ye senkronize edilmez. Böyle bir yapılandırmayı değiştirmek için yalnızca CR'yi değiştirin. Bu işlem yapılandırma tutarsızlıklarını önler.

  • Mevcut LogStore'lar — CR'de belirttiğiniz LogStore zaten varsa sonraki tüm LogStore ile ilgili parametreler etkili olmaz.

  • Değiştirilemeyen yapılandırma adı — Logtail yapılandırmasını oluşturduktan sonra adını yani configName parametresinin değerini değiştiremezsiniz.

  • alibaba-log-controller sürümü — Bazı parametreler alibaba-log-controller'ın asgari bir sürümünü gerektirir. CR'yi yazmadan önce CR parametreleri bölümünde her parametre için belirtilen asgari sürümü kontrol edin.

Yordam

Logtail yapılandırması oluşturun

AliyunLogConfig üzerinden bir CR oluşturun. CR'yi oluşturduktan sonra alibaba-log-controller CR'ye göre bir Logtail yapılandırması oluşturur ve yapılandırmayı otomatik olarak uygular.

  1. Kümenin kubeconfig dosyasını edinin ve kubectl kullanarak kümeye bağlanın.

  2. Bir YAML dosyası oluşturmak için aşağıdaki komutu çalıştırın. Bu örnekte dosya adı cube.yaml şeklindedir. Dosya adını gerektiği gibi değiştirin.

    vim cube.yaml
  3. YAML dosyasına aşağıdaki betiği girin ve parametreleri gerektiği gibi yapılandırın. Betik yalnızca gerekli alanları içerir. Günlüklerin nasıl toplanacağını belirtmek için inputType öğesini ayarlayın ve günlük girişi ayarlarını yapılandırmak için inputDetail öğesini ayarlayın. CR alanları hakkında daha fazla bilgi için bkz. CR parametreleri.

    apiVersion: log.alibabacloud.com/v1alpha1      # Use the default value. You do not need to modify this parameter.
    kind: AliyunLogConfig                          # Use the default value. You do not need to modify this parameter.
    metadata:
      name: test-config                            # The name of the resource. The name must be unique in the current Kubernetes cluster.
    spec:
      logstore: k8s-stdout                         # The name of the Logstore. If the Logstore that you specify does not exist, Simple Log Service automatically creates the Logstore.
      logtailConfig:                               # The Logtail configuration.
        inputType: plugin                          # The type of the data source from which logs are collected.
        configName: test-config                    # The name of the Logtail configuration.
        inputDetail:                               # The details of the Logtail configuration.
          ...
  4. AliyunLogConfig üzerinden CR oluşturmak için aşağıdaki komutu çalıştırın. Logtail yapılandırması etkili olduktan sonra Logtail veri toplamaya başlar ve verileri Simple Log Service'e gönderir.

    kubectl apply -f cube.yaml
  5. CR'nin statusCode alanının değerinin 200 olduğunu doğrulayın. Talimatlar için bkz. Logtail yapılandırmalarını görüntüleme.

Logtail yapılandırmalarını görüntüleyin

Mevcut Kubernetes kümesinde AliyunLogConfig tarafından oluşturulan tüm Logtail yapılandırmalarını görüntülemek için aşağıdaki komutu çalıştırın:

kubectl get aliyunlogconfigs

AliyunLogConfig tarafından oluşturulan tek bir Logtail yapılandırmasının ayrıntılarını ve durumunu görüntülemek için aşağıdaki komutu çalıştırın. <config_name> AliyunLogConfig öğesinin adıdır. Adı gerektiği gibi değiştirin.

kubectl get aliyunlogconfigs <config_name> -o yaml

Aşağıdakine benzer bir sonuç döndürülür. Bu örnekte Logtail yapılandırması inputType: file kullanır.

apiVersion: log.alibabacloud.com/v1alpha1
kind: AliyunLogConfig
metadata:
  name: example-k8s-file
  namespace: kube-system
spec:
  project: k8s-log-test
  logstore: k8s-file
  logtailConfig:
    inputType: file
    configName: example-k8s-file
    inputDetail:
      logType: common_reg_log
      logPath: /data/logs/app_1
      filePattern: test.LOG
      dockerFile: true
status:
  status: OK
  statusCode: 200

Sonuçtaki status ve statusCode alanları Logtail yapılandırmasının durumunu gösterir:

  • statusCode alanının değeri 200 ise Logtail yapılandırması uygulanmıştır.

  • statusCode alanının değeri 200 değilse Logtail yapılandırması uygulanamamıştır. Bildirilen durumu kontrol etmek için status alanını inceleyin.

Logtail yapılandırmasını güncelleyin

AliyunLogConfig tarafından oluşturulan bir Logtail yapılandırmasını güncellemek için CR'nin mevcut YAML dosyasını değiştirin ve dosyayı tekrar uygulayın.

  1. Kümenin kubeconfig dosyasını edinin ve kubectl kullanarak kümeye bağlanın.

  2. Mevcut AliyunLogConfig YAML dosyasını örneğin cube.yaml dosyasını düzenleyin.

    vim cube.yaml
  3. YAML dosyasındaki parametreleri gerektiği gibi değiştirin. CR alanları hakkında daha fazla bilgi için bkz. CR parametreleri.

  4. Dosyayı uygulamak ve Logtail yapılandırmasının etkili olmasını sağlamak için aşağıdaki komutu çalıştırın.

    kubectl apply -f cube.yaml
  5. CR'nin statusCode alanının değerinin 200 olduğunu doğrulayın. Talimatlar için bkz. Logtail yapılandırmalarını görüntüleme.

Logtail yapılandırmasını silin

AliyunLogConfig tarafından oluşturulan bir Logtail yapılandırmasını silmek için ilgili CR'yi silin. Aşağıdaki komutta <config_name> AliyunLogConfig öğesinin adıdır. Adı gerektiği gibi değiştirin.

Önemli

CR silindikten sonra karşılık gelen Logtail yapılandırması da otomatik olarak silinir.

kubectl delete aliyunlogconfigs <config_name>

Silme işlemini onaylamak için kubectl get aliyunlogconfigs komutunu çalıştırın ve CR'nin artık listelenmediğini kontrol edin.

CR parametreleri

Aşağıdaki bölümlerde bir AliyunLogConfig CR'sinin alanları açıklanmaktadır.

apiVersion

Değer log.alibabacloud.com/v1alpha1 olarak sabittir.

kind

Değer AliyunLogConfig olarak sabittir.

metadata

metadata alanı Kubernetes kümesindeki CR'yi tanımlar.

Parametreler Tür Gerekli Açıklama
name string Evet CR'nin benzersiz tanımlayıcısı. En iyi uygulama olarak spec.logtailConfig.configName ile aynı değeri kullanın.
namespace string Hayır CR'nin ait olduğu ad alanı.

spec

spec alanı hedef proje ve LogStore'u, hedef LogStore'un niteliklerini ve Logtail yapılandırmasının ayrıntılarını belirtir.

Parametreler Tür Gerekli Açıklama
project string Hayır Hedef projenin adı. Varsayılan değer küme için yapılandırılan projedir; bu değer alibaba-log-controller'ın ALICLOUD_LOG_PROJECT ortam değişkeninin değeridir. Belirttiğiniz proje yoksa Simple Log Service projeyi otomatik olarak oluşturur.
logstore string Evet Hedef LogStore'un adı. Belirttiğiniz LogStore yoksa Simple Log Service LogStore'u otomatik olarak oluşturur.
logtailConfig AliyunLogConfigDetail Evet Logtail yapılandırmasının ayrıntıları.
uid string Hayır Hedef hesabın UID'si. Günlükleri hesaplar arasında aktarmak için bu parametreyi yapılandırın ve alibaba-log-controller'ın ortam değişkenlerinde ALICLOUD_LOG_ACCOUNT_INFOS={"<uid>":{"accessKeyID":"<your_access_key_id>","accessKeySecret":"<your_access_key_secret>"}} değerini ayarlayın. Bu parametre yalnızca projenin ait olduğu hesabı kontrol eder. Logtail verilerini o hesaba aktarmak için Logtail için bir kullanıcı tanımlayıcısı da yapılandırmanız gerekir. Talimatlar için bkz. Kullanıcı tanımlayıcısı yapılandırma. Bu parametre yalnızca alibaba-log-controller 0.3.2 veya sonraki sürümler tarafından desteklenir.
endpoint string Hayır Hedef projenin uç noktası. Varsayılan olarak mevcut kümenin bulunduğu bölgenin uç noktası kullanılır. Hedef proje ve küme farklı bölgelerde bulunuyorsa bu parametreyi yapılandırın. Bu parametre yalnızca Logtail yapılandırmasının kullandığı uç noktayı kontrol eder. Logtail verilerini o bölgeye aktarmak için Logtail için config_server_address ve data_server_list parametrelerini de yapılandırmanız gerekir. Talimatlar için bkz. Logtail yapılandırma dosyaları ve kayıt dosyaları. Bu parametre yalnızca alibaba-log-controller 0.4.1 veya sonraki sürümler tarafından desteklenir. Daha fazla bilgi için bkz. Uç nokta.
logstoreMode string Hayır Hedef LogStore'un türü. Varsayılan değer: standard. Geçerli değerler: query (Sorgu LogStore'u) ve standard (Standart LogStore). Bu parametre yalnızca alibaba-log-controller 0.3.3 veya sonraki sürümler tarafından desteklenir. Ayrıntılar için bkz. LogStore türleri.
shardCount int Hayır Hedef LogStore'daki parça sayısı. Varsayılan değer: 2. Geçerli değerler: 1-10. Ayrıntılar için bkz. Parçalar.
logstoreMaxSplitShard int Hayır Hedef LogStore'daki parçaların otomatik olarak bölünebileceği maksimum parça sayısı. Varsayılan değer: 32. Geçerli değerler: 1-256. Ayrıntılar için bkz. otomatik parçalama.
logstoreAutoSplit bool Hayır Hedef LogStore için otomatik parçalamanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: true. Ayrıntılar için bkz. otomatik parçalama.
lifeCycle int Hayır Hedef LogStore'un veri saklama süresi. Birim: gün. Varsayılan değer: 180. Geçerli değerler: 1-3650. 3650 değeri kalıcı saklamayı belirtir. Ayrıntılar için bkz. Veri Saklama Süresi.
logstoreHotTTL int Hayır Hedef LogStore'un sıcak veri saklama süresi. Birim: gün. Varsayılan değer: 0. Değer lifeCycle değerinden küçük ve 7'den büyük veya buna eşit olmalıdır. Ayrıntılar için bkz. Akıllı Katmanlı Depolama.
logstoreTelemetryType string Hayır Hedef LogStore'daki gözlemlenebilirlik verilerinin türü. Varsayılan değer: None. Geçerli değerler: None (günlük verisi) ve Metrics (ölçüm verisi). Ayrıntılar için bkz. telemetryType.
logstoreAppendMeta bool Hayır Hedef LogStore için genel IP adreslerini kaydetme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: true. Ayrıntılar için bkz. Genel IP Günlüğü.
logstoreEnableTracking bool Hayır Hedef LogStore için Web İzlemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false. Ayrıntılar için bkz. WebTracking.
logstoreEncryptConf object Hayır Hedef LogStore'un şifreleme ayarları. Bu parametre varsayılan olarak boştur. Ayrıntılar için bkz. Ortak veri yapıları.
logstoreMeteringMode string Hayır Hedef LogStore'un faturalama modu. Bu parametre varsayılan olarak boştur. Geçerli değerler: ChargeByFunction (özellik bazlı ödeme faturalama modu) ve ChargeByDataIngest (alınan veri bazlı ödeme faturalama modu). LogStore'un logstoreMode değeri query ise yalnızca özellik bazlı ödeme faturalama modu desteklenir. Hesabınız için alınan veri bazlı ödeme faturalama modu etkinleştirilmemişse bu parametreyi yalnızca ChargeByFunction olarak ayarlayabilirsiniz. Bu parametre yalnızca alibaba-log-controller 0.4.3 veya sonraki sürümler tarafından desteklenir. Ayrıntılar için bkz. LogStore'ları yönetme.
machineGroups array Hayır Logtail yapılandırmasıyla ilişkili makine grupları. logtail-ds bileşenini yüklediğinizde Simple Log Service k8s-group-${your_k8s_cluster_id} adlı bir makine grubunu otomatik olarak oluşturur. Bu makine grubu varsayılan değerdir. Ayrıntılar için bkz. Giriş.
configTags map Hayır Logtail yapılandırmasını tanımlamak için kullanılan özel etiketler. Bu parametre yalnızca alibaba-log-controller 0.4.2 veya sonraki sürümler tarafından desteklenir.

AliyunLogConfigDetail

Parametreler hakkında daha fazla bilgi için bkz. Logtail yapılandırmaları (eski). AliyunLogConfigDetail veri biçimi Logtail yapılandırmaları (eski) bölümünde açıklanan biçimle aynıdır.

Parametreler Tür Gerekli Açıklama
configName string Evet Logtail yapılandırmasının adı. Ad Logtail yapılandırmasının ait olduğu projede benzersiz olmalıdır. En iyi uygulama olarak kaynak adıyla (metadata.name) aynı değeri kullanın. Ad yalnızca küçük harfler, rakamlar, tire (-) ve alt çizgi (_) içerebilir. Ad küçük harf veya rakamla başlamalı ve bitmelidir. Ad 2-128 karakter uzunluğunda olmalıdır.
logSample string Hayır Örnek günlük. Değerin uzunluğu 1.500 bayttan az olmalıdır.
inputType string Evet Günlüklerin toplanma yöntemi. Geçerli değerler: plugin (Logtail eklentilerini kullanarak standart çıkış günlükleri ve MySQL ikili günlükleri gibi günlükleri toplar) ve file (tam normal ifade modu ve sınırlayıcı modu gibi sabit modlarda metin dosyalarından günlükleri toplar).
inputDetail Object Evet Günlük girdisinin ayarları. Ayrıntılar için bkz. inputDetail.