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
Logtail bileşenlerinin v0.5.1 veya sonraki bir sürümü yüklüdür. Daha fazla bilgi için bkz. ACK kümesine Logtail bileşenlerini yükleme ve Kendi yönetimindeki Kubernetes kümesine Logtail bileşenlerini yükleme.
-
Hedef konteyner aktif olarak günlük oluşturmaktadır.
ÖnemliLogtail yalnızca artımlı günlükleri toplar. Yapılandırma tesliminden sonra bir günlük dosyası güncellenmezse Logtail bu dosyayı atlar. Günlükleri okuma.
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
configNameparametresinin 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.
Kümenin kubeconfig dosyasını edinin ve kubectl kullanarak kümeye bağlanın.
-
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 -
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çininputDetailöğ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. ... -
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 CR'nin
statusCodealanı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:
statusCodealanının değeri 200 ise Logtail yapılandırması uygulanmıştır.statusCodealanının değeri 200 değilse Logtail yapılandırması uygulanamamıştır. Bildirilen durumu kontrol etmek içinstatusalanı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.
Kümenin kubeconfig dosyasını edinin ve kubectl kullanarak kümeye bağlanın.
-
Mevcut
AliyunLogConfigYAML dosyasını örneğincube.yamldosyasını düzenleyin.vim cube.yaml YAML dosyasındaki parametreleri gerektiği gibi değiştirin. CR alanları hakkında daha fazla bilgi için bkz. CR parametreleri.
-
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 CR'nin
statusCodealanı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.
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. |