Sunucu günlüklerini toplamak için bir Simple Log Service projesi kullanmadan önce her hedef sunucuya Logtail istemcisini yükleyin. Bu konuda, sunucu ortamlarında ve konteyner ortamlarında Logtail'in nasıl yükleneceği, başlatılacağı, durdurulacağı, yükseltileceği ve kaldırılacağı açıklanmaktadır.
Genel bakış
Logtail, hedef sunucunun türüne bağlı olarak aşağıdaki iki senaryodan birinde kullanılır:
fiziksel sunucular ve Elastic Compute Service (ECS) örnekleri gibi geleneksel bilişim ortamları için.
-
Kubernetes konteyner platformunda dağıtılan iş yükleri için.
Sunucularınızın çalışma zamanı ortamına uygun çözümü seçin. Prosedür ve yapılandırma gereksinimleri bu iki senaryo arasında farklılık gösterir. Hibrit bir dağıtımda, her ortam için kurulumu ve yapılandırmayı ayrı ayrı tamamlayın.
Sunucular
Logtail'i yükleme
Logtail'i iki yoldan biriyle yükleyebilirsiniz: tek tıkla yükleme veya manuel yükleme. Simple Log Service, yalnızca ECS örnekleri kullandığınızda ve örnekler ile projenin aynı Alibaba Cloud hesabına ait olup aynı bölgede bulunması durumunda tek tıkla yüklemeyi destekler. Diğer tüm durumlarda Logtail'i manuel olarak yükleyin.
Tek tıkla yükleme
Simple Log Service, Logtail'i bir ECS örneğine tek tıkla yükleyebilir. Yükleme, CloudOps Orchestration Service (OOS) düzenleme yeteneğine dayandığından ECS örneğinde oturum açıp yükleme adımlarını manuel olarak çalıştırmanız gerekmez. Bir Alibaba Cloud hesabıyla oturum açarsanız varsayılan olarak gerekli tüm izinlere sahip olursunuz ve işlemleri doğrudan gerçekleştirebilirsiniz.
Bir RAM kullanıcısı olarak oturum açıyorsanız Alibaba Cloud hesabı sahibinden OOS kaynaklarını yönetme izni vermesini isteyin. Hesap sahibi, sistem ilkesi veya özel bir ilke kullanarak RAM kullanıcısı oluşturabilir ve RAM kullanıcısına izin verebilir:
-
Sistem ilkeleri:
AliyunOOSFullAccess: CloudOps Orchestration Service (OOS) yönetimi için tam izinler verir.AliyunECSFullAccess: ECS yönetimi için izinler verir.
Özel ilkeler: Katı veri güvenliği gereksinimleriniz varsa hassas yetkilendirme için özel bir ilke oluşturabilirsiniz. Aşağıdaki ilke, OOS kaynaklarını yönetmek için izinler verir:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecs:DescribeTagKeys",
"ecs:DescribeTags",
"ecs:DescribeInstances",
"ecs:DescribeInvocationResults",
"ecs:RunCommand",
"ecs:DescribeInvocations",
"ecs:InvokeCommand"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"oos:ListTemplates",
"oos:StartExecution",
"oos:ListExecutions",
"oos:GetExecutionTemplate",
"oos:ListExecutionLogs",
"oos:ListTaskExecutions"
],
"Resource": "*"
}
]
}
Bir ECS örneğine Logtail yüklemek ve aynı anda bir makine grubu oluşturup yapılandırmak için aşağıdaki adımları uygulayın:
-
Simple Log Service konsolunda oturum açın. Günlük kaynaklarınızı yöneten projeyi tıklayarak LogStore listesini görüntüleyin. Günlükleri depolayan LogStore adının önündeki
simgesini tıklayarak genişletin, Data Collection öğesinin ardından çıkan
simgesini tıklayın, iletişim kutusunda bir metin günlüğü şablonu seçin ve ardından Integrate Now öğesine tıklayın.Simple Log Service; normal ifade, tek satırlı ve çok satırlı şablonlar gibi birden fazla metin günlüğü şablonu sağlar. Şablonlar yalnızca günlük ayrıştırma eklentileri bakımından farklılık gösterir. Diğer tüm yapılandırmalar aynıdır. Bir şablondaki günlük ayrıştırma eklentilerini ekleyebilir veya kaldırabilirsiniz. Toplamak istediğiniz günlüklerin özelliklerine göre bir şablon seçin veya herhangi bir metin günlüğü şablonu seçip günlüklerinizin özelliklerine göre eklentileri yapılandırın.
Machine Group Configurations sayfasında yükleme ortamı olarak Servers ve ECS seçeneklerini belirleyin, ardından Create Machine Group öğesine tıklayın.
-
Create Machine Group panelinde proje ile aynı bölgede bulunan bir veya daha fazla ECS örneği seçin, Install and Create Machine Group öğesine tıklayın, yüklemenin tamamlanmasını bekleyin, makine grubunun Name değerini belirtin ve OK düğmesine tıklayın.
Yükleme başarısız olursa veya bekleme durumunda kalırsa ECS örneklerinin proje ile aynı bölgede bulunduğunu kontrol edin.
Yüklemeden sonra
Resources > Machine Groups sayfasına gidin, oluşturduğunuz makine grubuna tıklayın ve Machine Group Configurations > Machine Group Status bölümünde Heartbeat durumunu kontrol edin. Heartbeat durumunun OK olması makine grubunun oluşturulduğunu gösterir.
Manuel yükleme
Sunucunuzun işletim sistemi ve CPU mimarisine göre bir Logtail indirme yöntemi ve yükleme yöntemi seçin.
Örnek kodda ${region_id} Simple Log Service projesinin bulunduğu bölgedir. Desteklenen bölgeler konusuna bakarak bunu gerçek bölge kimliği ile değiştirin. Örneğin China (Hangzhou) bölgesi için ${region_id} değeri cn-hangzhou şeklindedir.
Logtail'i yüklemeden önce aşağıdaki hususları göz önünde bulundurun:
Logtail 2.0 uyumluluğu: Makinenizin teknik özellikleri düşükse veya eski bir işletim sistemi çalıştırıyorsa Logtail 2.0 uyumluluk sorunlarına neden olabilir ve yazılımın düzgün çalışmasını engelleyebilir. Bu durumda sürüm 1.8.7'yi
https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/1.8.7/logtail.shadresinden indirip./logtail.sh install ${region_id} -v 1.8.7komutunu çalıştırarak yüklemenizi öneririz.
Linux
-
Aşağıdaki Linux x86-64 (64 bit) sunucu sürümleri desteklenir. - Alibaba Cloud Linux 2 ve 3
Anolis OS 7 ve 8 - CentOS Linux 6, 7 ve 8 - Debian GNU/Linux 8, 9, 10, 11 ve 12
Red Hat Enterprise Linux 6, 7, 8 ve 9
openSUSE 15.1, 15.2 ve 42,3
SUSE Linux Enterprise Server 11, 12 ve 15 - Ubuntu 14.04, 16,04, 18,04, 20,04, 22,04 ve 24,0 - glibc 2.5 veya sonraki sürümlerine dayalı diğer Linux işletim sistemleri. Logtail 2.0 veya sonraki sürümler glibc 2.6 veya sonraki bir sürümü gerektirir.
CPU, Logtail 2.0 veya sonraki sürümler için sse4_2 ve avx komut kümelerini desteklemelidir. - Aşağıdaki Linux ARM (64 bit) sunucu sürümleri desteklenir. - ARM için Alibaba Cloud Linux 3.2 - ARM için Anolis OS 8.2 veya sonraki sürümler - ARM için CentOS 8.4
ARM için Debian 11.2 ve 12.2 - ARM için Ubuntu 20.04, 22,04 ve 24,04
Logtail 2.0 veya sonraki sürümler için gereken minimum CPU mimarisi ARMv8.2-A'dır.
İnternete erişebilen sunucular (ARM ve x86-64)
İnternete erişebilen sunucular için Logtail'i doğrudan indirin:
# Download over an internal network
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh;
# Download over the internet
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;
Ağ koşullarınıza göre bir yükleme komutu seçin:
# Install over the internet.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
# Install over an internal network. This method applies to on-premises data centers that are connected to an internal network.
chmod +x logtail.sh; ./logtail.sh install ${region_id}
Çevrimdışı ARM sunucuları
Çevrimdışı sunucular için öncelikle internete erişebilen bir sunucuda yükleme betiğini ve yükleme paketini indirin:
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz
Yükleme betiğini ve yükleme paketini Logtail'i yüklemek istediğiniz sunucuya kopyalayın, ardından ağ koşullarınıza göre bir yükleme komutu seçin:
# Install over the internet.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration
Çevrimdışı x86-64 sunucuları
Çevrimdışı sunucular için öncelikle internete erişebilen bir sunucuda yükleme betiğini ve yükleme paketini indirin:
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz
Yükleme betiğini ve yükleme paketini Logtail'i yüklemek istediğiniz sunucuya kopyalayın, ardından ağ koşullarınıza göre bir yükleme komutu seçin:
# Install over the internet.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration
Windows
> - Microsoft Windows Server 2008 ve Microsoft Windows 7 üzerinde Logtail'i x86 veya x86_64 sürümüne yükleyebilirsiniz. > - Diğer Windows işletim sistemlerinde Logtail'i yalnızca x86_64 sürümüne yükleyebilirsiniz.
Aşağıdaki Windows sürümleri desteklenir: - Microsoft Windows Server 2008, 2012, 2016, 2019, 2022 ve 2025 - Microsoft Windows 7 - Microsoft Windows 10 - Microsoft Windows Server Version 1909 - Microsoft Windows Server Version 2004
Sunucunuzun mimarisine ve projenizin bölgesine uygun yükleme paketini indirin:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Yükleme paketini ayıklayın, Windows PowerShell'i yönetici olarak çalıştırın ve yükleme paketini ayıkladığınız dizin olan logtail_installer dizinine gidin. Ağ koşullarınıza göre bir yükleme komutu seçin:
# Install over the internet.
.\logtail_installer.exe install ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
.\logtail_installer.exe install ${region_id}-acceleration
Logtail'i toplu yükleme
Logtail'i aşağıdaki iki yoldan biriyle toplu olarak yükleyebilirsiniz:
OOS düzenleme: İzin gereksinimi olan senaryolar için geçerlidir. Bu yöntem yüksek eşzamanlılığı destekler ve büyük ölçekli toplu işlemler için uygundur. Daha fazla bilgi için OOS kullanarak Logtail'i toplu yükleme veya yükseltme konusuna bakın.
-
ECS Cloud Assistant: Kullanımı basittir. Tek seferlik bir görev gerçekleştirmek için bir komut çalıştırırsınız.
ECS Cloud Assistant kullanarak Logtail'i toplu yüklemek için aşağıdaki adımları uygulayın:
ECS konsolu - Cloud Assistant,Sayfanın sol üst köşesinde bir bölge ve kaynak grubu seçin.
-
Create Command panelinde Command Content alanına yükleme komutunu girin. Bu örnekte internet üzerinden yükleme kullanılmaktadır.
Bu örnekte aşağıdaki yükleme komutu kullanılır:
#!/bin/bash region_id='cn-hangzhou' wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh chmod +x logtail.sh ./logtail.sh install ${region_id}-internet Select Instances bölümünde hedef örneklerin Agent durumunun Normal olduğunu doğrulayın. Durum anormal ise Cloud Assistant yüklemesini tamamlamak için Cloud Assistant Agent'ı yükleme konusuna bakın. Hedef örnekleri seçin ve Execute öğesine tıklayın. Yürütme durumu daha sonra Execution Succeeded olarak değişir. Yürütme başarısız olursa Yürütme sonuçlarını görüntüleme ve yaygın sorunları giderme konusuna bakın.
Logtail'i başlatma ve durdurma
Linux
Logtail'i başlatma
sudo /etc/init.d/ilogtaild start
Logtail'i durdurma
sudo /etc/init.d/ilogtaild stop
Windows
Hedef sunucuda oturum açın.
Start > Control Panel > Tools > Service yolunu izleyin.
-
Service iletişim kutusunda gerekli hizmeti bulun.
0.x.x.x sürümü için LogtailWorker hizmetini seçin.
1.0.0.0 veya sonraki sürümler için LogtailDaemon hizmetini seçin.
Hizmete sağ tıklayıp Start, Stop veya Restart gibi gerekli işlemi seçin.
Logtail durumunu ve sürümünü kontrol etme
Linux
Linux'ta Logtail durumunu kontrol etme
Logtail durumunu kontrol etmek için sudo /etc/init.d/ilogtaild status komutunu çalıştırın. Sistem ilogtail is running yanıtını döndürürse Logtail yüklüdür. Logtail çalışmıyorsa kaldırıp yeniden yükleyin.
Linux'ta Logtail sürümünü kontrol etme
Logtail sürüm bilgilerini /usr/local/ilogtail/app_info.json dosyasının logtail_version alanında saklar. Logtail sürüm bilgilerini görüntülemek için aşağıdaki komutu çalıştırın.
cat /usr/local/ilogtail/app_info.json
Aşağıdaki sonuç döndürülür:
{
"logtail_version" : "0.16.30",
}
Windows
Windows'ta Logtail durumunu kontrol etme
Hedef sunucuda Logtail'in yüklü olup olmadığını belirlemek için Logtail durumunu kontrol edin.
Çalıştır penceresini açın,
services.mscgirin ve Hizmetler penceresini açın.-
Logtail 1.0.0.0 veya sonraki sürümler için geçerli olan LogtailDaemon hizmetinin veya Logtail 0.x.x.x için geçerli olan LogtailWorker hizmetinin çalışma durumunu kontrol edin.
Running durumu Logtail'in yüklü olduğunu gösterir.
Windows'ta Logtail sürümünü kontrol etme
Logtail sürümünü yükleme yolundaki app_info.json dosyasının logtail_version alanında kontrol edebilirsiniz.
Örneğin aşağıdaki içerik Logtail sürümünün 1.0.0.0 olduğunu gösterir.
{
"logtail_version" : "1.0.0.0"
}
Logtail'i yükseltme
Linux
Bir Linux sunucusunda Logtail'i yükseltmeden önce aşağıdaki hususları göz önünde bulundurun:
Yükseltme komutu: Logtail'i yükseltmek için
upgradekomutunu kullanın.installkomutunu kullanırsanız üzerine yazarak yükleme yapılır ve orijinal yapılandırmalar kaybolur.-
Hizmet kesintisi: Yükseltme sırasında Logtail kısa bir süre durur. Yükseltme tamamlandıktan sonra Logtail otomatik olarak başlar ve başlangıç öğesi olarak kaydedilir. Yükseltme yalnızca gerekli dosyaların üzerine yazar. Yapılandırma dosyaları ve kontrol noktası dosyaları korunur; bu da yükseltme sırasında günlük kaybı olmamasını sağlar.
Örnek kodda
${region_id}Simple Log Service projesinin bulunduğu bölgedir. Desteklenen bölgeler konusuna bakarak bunu gerçek bölge kimliği ile değiştirin. Örneğin China (Hangzhou) bölgesi için${region_id}değericn-hangzhouşeklindedir.
Aşağıdaki tablodan bir Logtail yükseltme yöntemi seçin:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Aşağıdaki bilgiler yükseltmenin başarılı olduğunu gösterir.
stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
"UUID" : "XXXXXXXX-XXXX",
"compiler" : "GCC 9.3.1",
"hostname" : "xxx",
"instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
"ip" : "172.16.0.75",
"logtail_version" : "2.0.8",
"os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
"update_time" : "2024-11-07 11:32:52"
}
Windows
Yükseltme prosedürü yükleme prosedürü ile aynıdır. En son yükleme paketini indirip ayıklayın ve ardından yükleme adımlarını uygulayın.
Yükseltme, otomatik kaldırma ve yeniden yüklemeye eşdeğerdir. Orijinal yükleme dizinindeki içerik silinir. Yükseltmeyi gerçekleştirmeden önce verilerinizi yedekleyin.
64 bit Windows işletim sisteminde 32 bit Logtail'i 64 bit Logtail'e yükseltmek için önce 32 bit Logtail'i kaldırmalı ve ardından 64 bit Logtail'i yüklemelisiniz.
Logtail'i kaldırma
Linux
Simple Log Service projenizin bulunduğu bölgenin ${region_id} değerini alın. ${region_id} değerini değiştirip Logtail'i kaldırmak için aşağıdaki komutu çalıştırın.
Her bölgenin ${region_id} değeri için Desteklenen bölgeler konusuna bakın. Örneğin China (Hangzhou) bölgesi için ${region_id} değeri cn-hangzhou şeklindedir.
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall
Windows
Windows PowerShell veya cmd'yi yönetici olarak çalıştırın, yükleme paketini ayıkladığınız dizin olan logtail_installer dizinine gidin ve ardından aşağıdaki komutu çalıştırın.
.\logtail_installer.exe uninstall
Kaldırma tamamlandıktan sonra Logtail yükleme dizini silinir ancak C:\LogtailData dizininde bazı yapılandırmalar korunur. Bunları ihtiyaçlarınıza göre manuel olarak silebilirsiniz. Korunan bilgiler şunlardır:
checkpoint: Tüm Logtail eklentilerinin kontrol noktası bilgilerini saklar. Bu dosya yalnızca Logtail eklentilerini kullandıktan sonra bulunur.
user_config.d: Yerel toplama yapılandırmalarını saklayan dizin. .json uzantılı dosyalar toplama yapılandırması olarak kabul edilir. Format /usr/local/ilogtail/user_log_config.json dosyasına benzer.
logtail_check_point: Ana Logtail bileşeninin kontrol noktası bilgilerini saklar.
users: Yapılandırdığınız kullanıcı tanımlayıcı dosyalarını saklar.
Konteyner senaryoları
Logtail bileşenini yükleme
Bir ACK kümesi kullanıyorsanız ve küme Simple Log Service ile aynı Alibaba Cloud hesabına aitse ACK kümeleri için yükleme yöntemine bakın. Kendi yönetiminizdeki bir küme kullanıyorsanız veya Simple Log Service ile farklı bir Alibaba Cloud hesabına ait bir ACK kümesi kullanıyorsanız kendi yönetiminizdeki kümeler için yükleme yöntemine bakın.
ACK kümeleri
Bu işlem yalnızca özel Kubernetes kümeleri ve yönetilen Kubernetes kümeleri için geçerlidir.
Mevcut bir ACK kümesi için Logtail bileşenini yükleme
Container Service Management Console'da oturum açın
Clusters sayfasında hedef kümenin en sağ sütununda More > Operations > Add-ons yolunu izleyin.
-
Logs and Monitoring sekmesinde
logtail-dsöğesini bulun ve ardından Install öğesine tıklayın.Yükleme tamamlandıktan sonra Simple Log Service otomatik olarak
k8s-log-${your_k8s_cluster_id}adlı bir proje oluşturur.
Bir ACK kümesi oluştururken Logtail bileşenini yükleme
Container Service Management Console'da oturum açın
Sol gezinme bölmesinde Clusters öğesine tıklayın.
Clusters sayfasında Create Cluster öğesine tıklayın.
Component Configurations yapılandırma adımında Enable Log Service seçeneğini belirleyin.
Bu bölümde yalnızca Simple Log Service'i etkinleştirmenin temel adımları açıklanmaktadır. Küme oluşturma hakkında daha fazla bilgi için Yönetilen bir ACK kümesi oluşturma konusuna bakın.
Enable Log Service seçeneğini belirlediğinizde bir proje oluşturmanızı isteyen bir mesaj görünür. Simple Log Service'in günlükleri nasıl organize ettiği hakkında daha fazla bilgi için Project konusuna bakın. Bir projeyi aşağıdaki iki yoldan biriyle oluşturabilirsiniz:
Select Project: Toplanan konteyner günlüklerini yönetmek için mevcut bir proje seçebilirsiniz.
-
Create Project: Simple Log Service, toplanan konteyner günlüklerini yönetmek için otomatik olarak bir proje oluşturur.
ClusterIDoluşturduğunuz Kubernetes kümesinin benzersiz tanımlayıcısıdır.Log Service bölümünde Enable Log Service seçeneğini belirleyin. Create a new project seçeneğini belirlediğinizde sistem otomatik olarak
k8s-log-{ClusterID}adlı bir proje oluşturur.
Yükleme tamamlandıktan sonra seçilen projede aşağıdaki Simple Log Service kaynakları otomatik olarak oluşturulur.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Kendi yönetiminizdeki kümeler
-
Kubernetes kümenizde oturum açın ve bölgeye göre Logtail'i ve bağımlı bileşenlerini indirmek için bir komut seçin.
# Regions in the Chinese mainland wget https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh # Regions outside the Chinese mainland wget https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh -
./alibaba-cloud-log-all/values.yamlyapılandırma dosyasını değiştirin.Yapılandırma dosyası aşağıdaki parametreleri içerir:
# ===================== Required content ===================== # The name of the destination project. SlsProjectName: # The region to which the project belongs. Region: # The ID of the Alibaba Cloud account to which the project belongs. Enclose the ID in double quotation marks (""). AliUid: "11099" # The AccessKey ID and AccessKey secret of the Alibaba Cloud account or the RAM user. The AliyunLogFullAccess permission is required. AccessKeyID: AccessKeySercret: # The custom cluster ID. The ID can contain only letters, digits, and hyphens (-). ClusterID: # ========================================================== # Specifies whether to enable the components related to metric collection. Valid values: true and false. Default value: true. SlsMonitoring: true # The network type. Valid values: Internet and Intranet. Default value: Internet. Net: Internet # Specifies whether the container runtime is containerd. Valid values: true and false. Default value: false. SLS_CONTAINERD_USED: true
Parametre
AçıklamaSlsProjectName
Logtail'in günlükleri yüklediği projenin adı.Region
Projenizin bulunduğu bölgenin kimliği. Örneğin China (Hangzhou) bölgesinin kimliğicn-hangzhouşeklindedir.AliUid
Projenin ait olduğu Alibaba Cloud hesabının kimliği. Kimlik çift tırnak içine ("") alınmalıdır, örneğinAliUid: "11**99".AccessKeyID
Projenin ait olduğu Alibaba Cloud hesabının AccessKey kimliği. Bir RAM kullanıcısının AccessKey çiftini kullanmanızı ve RAM kullanıcısına AliyunLogFullAccess izni vermenizi öneririz.AccessKeySercret
Projenin ait olduğu Alibaba Cloud hesabının AccessKey gizli anahtarı. Bir RAM kullanıcısının AccessKey çiftini kullanmanızı ve RAM kullanıcısına AliyunLogFullAccess izni vermenizi öneririz.ClusterID
Özel küme kimliği. Kimlik yalnızca harf, rakam ve tire (-) içerebilir. Bu parametre sonraki işlemlerdeki${your_k8s_cluster_id}parametresine karşılık gelir. Farklı Kubernetes kümeleri için aynı küme kimliğini yapılandırmayın.SlsMonitoring
Küme ölçüm verisi toplamayı etkinleştirip etkinleştirmeyeceğinizi belirtir. Geçerli değerler:true(varsayılan), küme ölçüm verisi toplamayı etkinleştirir vefalse, küme ölçüm verisi toplamayı devre dışı bırakır.Net
Logtail'in veri aktarmak için kullandığı ağ türü. Kümeniz Alibaba Cloud iç ağına bağlı değilse interneti kullanın. Geçerli değerler:Internet(varsayılan), internet anlamına gelir veIntranet, iç ağ anlamına gelir.SLS_CONTAINERD_USED
Konteyner çalışma zamanının containerd olup olmadığını belirtir. Geçerli değerler:true, konteyner çalışma zamanının containerd olduğunu gösterir vefalse(varsayılan), konteyner çalışma zamanının containerd olmadığını gösterir. Containerd'yi konteyner çalışma zamanı olarak kullanan kendi yönetiminizdeki bir Kubernetes kümesinde bu parametre etkinleştirilmezse Logtail günlükleri toplayamayabilir. -
Logtail'i ve bağımlı bileşenlerini yükleyin.
Ana bilgisayarınızın
OS-architecturedeğerini sorgulamak içinecho "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"komutunu çalıştırabilirsiniz.k8s-custom-install.shbetiği aşağıdakiOS-architecturekombinasyonlarını destekler: linux-386, linux-amd64, linux-arm, linux-arm64, linux-ppc64le, linux-s390x ve darwin-amd64.bash k8s-custom-install.sh; kubectl apply -R -f resultDeğiştirdiğiniz
values.yamldosyası.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Logtail durumu, sürümü ve IP adresi
Logtail durumunu kontrol etmek için aşağıdaki komutu çalıştırın.
kubectl get po -n kube-system | grep logtail
Aşağıdaki sonuç döndürülür:
NAME READY STATUS RESTARTS AGE
logtail-ds-gb92k 1/1 Running 0 2h
logtail-ds-wm7lw 1/1 Running 0 4d
Logtail'in sürüm numarası ve IP adresi gibi bilgileri görüntülemek için aşağıdaki komutu çalıştırın.
kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.json
Aşağıdaki sonuç döndürülür:
{
"hostname" : "logtail-ds-gb92k",
"instance_id" : "0EBB2B0E-0A3B-11E8-B0CE-0A58AC140402_172.20.4.2_1517810940",
"ip" : "192.0.2.0",
"logtail_version" : "0.16.2",
"os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
"update_time" : "2021-02-05 06:09:01"
}
Logtail'i yükseltme ve geri alma
-
Yükseltmeden önce Logtail bileşeninin açıklama dosyalarını yedekleyin.
Yükseltmeden önce zaten önemli toplama gecikmesi varsa Logtail yükseltmesi küçük miktarda günlük verisinin kaybolmasına neden olabilir.
kubectl get ds -n kube-system logtail-ds -o yaml > logtail-ds.yaml kubectl get deployment -n kube-system alibaba-log-controller -o yaml > alibaba-log-controller.yaml kubectl get crd aliyunlogconfigs.log.alibabacloud.com -o yaml > aliyunlogconfigs-crd.yaml kubectl get cm -n kube-system alibaba-log-configuration -o yaml > alibaba-log-configuration.yaml kubectl get aliyunlogconfigs --all-namespaces -o yaml > aliyunlogconfigs-cr.yaml Kümenize göre bir bileşen yükseltme yöntemi seçin. Bir ACK kümesi kullanıyorsanız ve küme Simple Log Service ile aynı Alibaba Cloud hesabına aitse ACK kümeleri için yükseltme yöntemine bakın. Kendi yönetiminizdeki bir küme kullanıyorsanız veya Simple Log Service ile farklı bir Alibaba Cloud hesabına ait bir ACK kümesi kullanıyorsanız kendi yönetiminizdeki kümeler için yükseltme yöntemine bakın.
ACK kümeleri
Çoğu durumda otomatik yükseltme yöntemini kullanmanızı öneririz. logtail-ds DaemonSet'inde veya alibaba-log-controller Deployment'ında ortam değişkenleri gibi parametreleri değiştirdiyseniz değişikliklerinizin sıfırlanmasını önlemek için manuel yükseltme yöntemini kullanın.
Otomatik yükseltme
Otomatik yükseltme, logtail-ds ve alibaba-log-controller içinde manuel olarak değiştirdiğiniz yapılandırmaları sıfırlar.
Container Service Management Console'da oturum açın.
Logs and Monitoring sekmesinde
logtail-dsöğesini bulun ve ardından Upgrade öğesine tıklayın.Update iletişim kutusunda OK öğesine tıklayın.
Logtail'in en son sürümüne yükseltemiyorsanız Kubernetes kümenizin sürümü çok eskidir. Önce Kubernetes kümesini yükseltin veya manuel yükseltme yöntemini kullanın.
Yükseltmeyi gerçekleştirdikten sonra Container Service yönetim konsolunda logtail-ds podlarının durumunu kontrol edebilirsiniz. Tüm logtail-ds podları Running durumundaysa yükseltme başarılıdır.
Manuel yükseltme
Manuel yükseltme, yapılandırmalarınızı Logtail bileşeninin en son sürümüne göre güncellemez, bu nedenle bazı özellik iyileştirmeleri kullanılamayabilir.
Manuel yükseltme logtail-ds ve alibaba-log-controller'ı kapsar. Çoğu durumda yeni Logtail sürümünün toplama yeteneklerini elde etmek için yalnızca logtail-ds öğesini yükseltmeniz yeterlidir. Yeni Logtail CRD tarafından sağlanan toplama yeteneklerini elde etmek için alibaba-log-controller'ı yükseltmeniz gerekir. Aşağıdaki adımlarda logtail-ds örnek olarak kullanılmıştır.
Container Service Management Console'da oturum açın
-
Workloads > DaemonSets yolunu izleyin.
Notalibaba-log-controller'ı yükseltmek için Workloads > Deployments yolunu izleyin. Ardından kube-system ad alanında alibaba-log-controller'ı bulun ve yükseltmeyi tamamlayın.
Namespace değerini kube-system olarak ayarlayın ve ardından
logtail-dsiçin Edit öğesine tıklayın.-
Aşağıdaki ortam değişkenlerinin var olup olmadığını kontrol edin.
ALIYUN_LOGTAIL_CONFIG, ALIYUN_LOGTAIL_USER_ID ve ALIYUN_LOGTAIL_USER_DEFINED_ID ortam değişkenleri yoksa Logtail sürümünüz çok eski olabilir. Logtail'i yükseltin.
Image Version için Select Image Version öğesine tıklayın.
Image Version iletişim kutusunda en son sürüme tıklayın ve ardından OK öğesine tıklayın.
-
Sayfanın sağ tarafında Update öğesine tıklayın.
Yükseltmeyi gerçekleştirdikten sonra Container Service yönetim konsolunda
logtail-dspodlarının durumunu kontrol edebilirsiniz. Tümlogtail-dspodları Running durumundaysa yükseltme başarılıdır.
Kendi yönetiminizdeki kümeler
En son Logtail bileşenini yükleyerek yükseltme yapmanızı öneririz. Yalnızca logtail-ds veya alibaba-log-controller gibi bazı bileşenlerin görüntü sürüm numarasını güncellerseniz yükseltme başarısız olabilir.
Otomatik yükseltmeyi tamamlamak için Logtail bileşenini yeniden yükleyin.
Belirli bir sürüme geri almak için aşağıdaki adımları uygulayın.
Yükseltmeden önce yedeklediğiniz YAML dosyaları yinelenen bilgiler içerir. Dosyaları Logtail yapılandırmalarını geri yüklemek için kullanabilmeniz amacıyla yinelenen bilgileri manuel olarak silmeniz gerekir. Bu işlemi gerçekleştirmek için kubectl-neat aracını kullanabilirsiniz. Silmeniz gereken alanlar metadata.creationTimestamp, metadata.generation, metadata.resourceVersion, metadata.uid ve status alanlarıdır.
-
İş gereksinimlerinize göre yükseltmeden sonra oluşturulan yeni Logtail yapılandırmalarını koruyup korumayacağınıza karar verin.
Korumak istemiyorsanız yükseltmeden sonra oluşturulan yeni Logtail yapılandırmalarını silebilirsiniz.
-
Yedek dosyalardaki yinelenen bilgileri silin.
cat logtail-ds.yaml | kubectl-neat > neat-logtail-ds.yaml cat alibaba-log-controller.yaml | kubectl-neat > neat-alibaba-log-controller.yaml cat aliyunlogconfigs-crd.yaml | kubectl-neat > neat-aliyunlogconfigs-crd.yaml cat alibaba-log-configuration.yaml | kubectl-neat > neat-alibaba-log-configuration.yaml cat aliyunlogconfigs-cr.yaml | kubectl-neat > neat-aliyunlogconfigs-cr.yaml -
Logtail yapılandırmalarını geri yüklemek için sadeleştirilmiş yedek dosyaları uygulayın.
kubectl apply -f neat-logtail-ds.yaml kubectl apply -f neat-alibaba-log-controller.yaml kubectl apply -f neat-aliyunlogconfigs-crd.yaml kubectl apply -f neat-alibaba-log-configuration.yaml kubectl apply -f neat-aliyunlogconfigs-cr.yaml
Logtail bileşenini kaldırma
Kümenize göre bir bileşen kaldırma yöntemi seçin. Bir ACK kümesi kullanıyorsanız ve küme Simple Log Service ile aynı Alibaba Cloud hesabına aitse ACK kümeleri için kaldırma yöntemine bakın. Kendi yönetiminizdeki bir küme kullanıyorsanız veya Simple Log Service ile farklı bir Alibaba Cloud hesabına ait bir ACK kümesi kullanıyorsanız kendi yönetiminizdeki kümeler için kaldırma yöntemine bakın.
ACK kümeleri
Container Service Management Console'da oturum açın
Logs and Monitoring sekmesinde
logtail-dsöğesini bulun ve ardından Uninstall öğesine tıklayın.Ekran talimatlarını izleyerek OK öğesine tıklayın ve kaldırmayı tamamlayın.
Kendi yönetiminizdeki kümeler
logtail-ds ve alibaba-log-controller gibi yüklü bileşenleri kaldırmak için kubectl delete -R -f result komutunu çalıştırın.
Bu komut result dizinindeki tüm kaynakları özyinelemeli olarak siler. Dizin başka kaynaklar içeriyorsa dikkatli kullanın.
Kümelerle ilgili SSS
Birden fazla Kubernetes kümesi tek bir Simple Log Service projesini nasıl paylaşır?
Birden fazla kümeden konteyner günlüklerini aynı Simple Log Service projesine toplamak istiyorsanız yükleme parametrelerini ilk küme için Simple Log Service bileşenini yüklerken kullandığınız parametrelerle aynı tutun.
Logtail günlüklerini nasıl görüntülerim?
Logtail günlükleri Logtail konteynerindeki /usr/local/ilogtail/ dizininde saklanır. Dosya adları ilogtail.LOG ve logtail_plugin.LOG şeklindedir.
Logtail konteynerinin standart çıktısı anlamlı değildir. Aşağıdaki standart çıktıyı yoksayın.
start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running
Bir Kubernetes kümesinde Simple Log Service bileşenlerinin durumunu nasıl kontrol ederim?
Aşağıdaki komutları çalıştırın.
kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-system
alibaba-log-controller başlatılamıyor. Ne yapmalıyım?
Yükleme işlemini aşağıdaki şekilde gerçekleştirip gerçekleştirmediğinizi kontrol edin.
Yükleme komutunu Kubernetes kümesinin master düğümünde çalıştırın.
-
Yükleme komutunun parametrelerine küme kimliğinizi girin.
Yükleme yukarıdaki nedenlerden herhangi biri nedeniyle başarısız olduysa oluşturulan yükleme şablonunu silmek için
kubectl delete -f deploykomutunu çalıştırın ve ardından yükleme komutunu yeniden çalıştırın.
Bir Kubernetes kümesinde Logtail-ds DaemonSet'inin durumunu nasıl kontrol ederim?
Logtail-ds DaemonSet'inin durumunu kontrol etmek için kubectl get ds -n kube-system komutunu çalıştırın.
Varsayılan olarak Logtail konteyneri kube-system ad alanında bulunur.
Logtail'in operasyonel günlüklerini nasıl görüntülerim?
Logtail'in operasyonel günlükleri /usr/local/ilogtail/ dizininde saklanır. Dosya adı ilogtail.LOG şeklindedir ve döndürülen dosyalar sıkıştırılarak ilogtail.LOG.x.gz olarak saklanır. Örneğin günlükleri görüntülemek için aşağıdaki komutu çalıştırın.
kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOG
Aşağıdaki sonuç döndürülür:
[2018-02-05 06:09:02.168693] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:104] logtail plugin Resume:start
[2018-02-05 06:09:02.168807] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:106] logtail plugin Resume:success
[2018-02-05 06:09:02.168822] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:369] start add existed check point events, size:0
[2018-02-05 06:09:02.168827] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:511] add existed check point events, size:0 cache size:0 event size:0 success count:0
Bir podda Logtail'i nasıl yeniden başlatırım?
Logtail'i durdurmak için aşağıdaki komutu çalıştırın. Komutta logtail-ds-gb92k konteyner adı ve kube-system ad alanıdır. Bunları gerçek değerlerle değiştirin.
kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stop
Aşağıdaki sonuç Logtail'in durdurulduğunu gösterir.
kill process Name: ilogtail pid: 7
kill process Name: ilogtail pid: 9
stop success
Logtail'i başlatmak için aşağıdaki komutu çalıştırın. Komutta logtail-ds-gb92k konteyner adı ve kube-system ad alanıdır. Bunları gerçek değerlerle değiştirin.
kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild start
Aşağıdaki sonuç Logtail'in başlatıldığını gösterir.
ilogtail is running