Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Simple Log Service'de Logtail'i yükleme, çalıştırma, yükseltme ve kaldırma

Son Güncelleme:Oct 14, 2026

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:

  1. 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 image simgesini tıklayarak genişletin, Data Collection öğesinin ardından çıkan image 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.

  2. Machine Group Configurations sayfasında yükleme ortamı olarak Servers ve ECS seçeneklerini belirleyin, ardından Create Machine Group öğesine tıklayın.

  3. 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.

  4. Yüklemeden sonra imageResources > 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.sh adresinden indirip ./logtail.sh install ${region_id} -v 1.8.7 komutunu ç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

Not

> - 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:


Mimari


Proje bölgesi


Yükleme paketi


32 bit


Çin anakarasındaki bölgeler


Logtail 32 bit yükleme paketi: https://logtail-release.oss-cn-hangzhou.aliyuncs.com/win/win32/1.6.1.0/logtail_installer.zip


32 bit


Çin anakarası dışındaki bölgeler


Logtail 32 bit yükleme paketi: https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/win/win32/1.6.1.0/logtail_installer.zip


64 bit


Çin anakarasındaki bölgeler


Logtail 64 bit yükleme paketi: https://logtail-release.oss-cn-hangzhou.aliyuncs.com/win/win64/1.6.1.0/logtail_installer.zip


64 bit


Çin anakarası dışındaki bölgeler


Logtail 64 bit yükleme paketi: https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/win/win64/1.6.1.0/logtail_installer.zip

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:

  1. ECS konsolu - Cloud Assistant,Sayfanın sol üst köşesinde bir bölge ve kaynak grubu seçin.

  2. 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

    Bir ECS örneğini klasik ağdan VPC'ye geçirdikten sonra makine grubu yapılandırmasını nasıl güncellerim?.

  3. 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

  1. Hedef sunucuda oturum açın.

  2. Start > Control Panel > Tools > Service yolunu izleyin.

  3. 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.

  4. 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.

  1. Çalıştır penceresini açın, services.msc girin ve Hizmetler penceresini açın.

  2. 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 upgrade komutunu kullanın. install komutunu 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ğeri cn-hangzhou şeklindedir.

Aşağıdaki tablodan bir Logtail yükseltme yöntemi seçin:


Mimari


İndirme yöntemi


Yükseltme yöntemi


ARM ve x86-64


İnternete erişebilen sunucular için: wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;


İndirme tamamlandıktan sonra aşağıdaki yükseltme komutunu çalıştırın: chmod +x logtail.sh; sudo ./logtail.sh upgrade;


ARM


Ç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ükseltmek istediğiniz sunucuya kopyalayın, ardından aşağıdaki yükseltme komutunu çalıştırın: chmod +x logtail.sh; ./logtail.sh upgrade-local;


x86-64


Ç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ükseltmek istediğiniz sunucuya kopyalayın, ardından aşağıdaki yükseltme komutunu çalıştırın: chmod +x logtail.sh; ./logtail.sh upgrade-local;

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.

Önemli
  • 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

  1. Container Service Management Console'da oturum açın

  2. Clusters sayfasında hedef kümenin en sağ sütununda More > Operations > Add-ons yolunu izleyin.

  3. 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

  1. Container Service Management Console'da oturum açın

  2. Sol gezinme bölmesinde Clusters öğesine tıklayın.

  3. Clusters sayfasında Create Cluster öğesine tıklayın.

  4. Component Configurations yapılandırma adımında Enable Log Service seçeneğini belirleyin.

Not

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. ClusterID oluş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.


Kaynak türü


Kaynak adı


Açıklama


Örnek


Makine grubu


k8s-group-${your_k8s_cluster_id}


Esas olarak günlük toplamak için kullanılan logtail-daemonset makine grubu.


k8s-group-my-cluster-123


Makine grubu


k8s-group-${your_k8s_cluster_id}-statefulset


Esas olarak ölçüm toplamak için kullanılan logtail-statefulset makine grubu.


k8s-group-my-cluster-123-statefulset


Makine grubu


k8s-group-${your_k8s_cluster_id}-singleton


Esas olarak bazı tek örnekli toplama yapılandırmaları için kullanılan tek örnekli makine grubu.


k8s-group-my-cluster-123-singleton


LogStore


config-operation-log


Logtail bileşenindeki alibaba-log-controller günlüklerini saklar. Bu LogStore'da toplama yapılandırmaları oluşturmanızı önermiyoruz. Bu LogStore'u silebilirsiniz. LogStore silindikten sonra alibaba-log-controller'ın operasyonel günlükleri artık toplanmaz. Bu LogStore, normal bir LogStore ile aynı şekilde faturalandırılır. Daha fazla bilgi için Pay-by-data-written billing konusuna bakın.


config-operation-log

Kendi yönetiminizdeki kümeler

  1. 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
  2. ./alibaba-cloud-log-all/values.yaml yapı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çıklama


    SlsProjectName


    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ği cn-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ğin AliUid: "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 ve false, 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 ve Intranet, 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 ve false (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.

  3. Logtail'i ve bağımlı bileşenlerini yükleyin.

    Ana bilgisayarınızın OS-architecture değerini sorgulamak için echo "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" komutunu çalıştırabilirsiniz. k8s-custom-install.sh betiği aşağıdaki OS-architecture kombinasyonları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 result

    Değiştirdiğiniz values.yaml dosyası.


Kaynak türü


Kaynak adı


Açıklama


Örnek


Makine grubu


k8s-group-${your_k8s_cluster_id}


Esas olarak günlük toplamak için kullanılan logtail-daemonset makine grubu.


k8s-group-my-cluster-123


Makine grubu


k8s-group-${your_k8s_cluster_id}-statefulset


Esas olarak ölçüm toplamak için kullanılan logtail-statefulset makine grubu.


k8s-group-my-cluster-123-statefulset


Makine grubu


k8s-group-${your_k8s_cluster_id}-singleton


Esas olarak bazı tek örnekli toplama yapılandırmaları için kullanılan tek örnekli makine grubu.


k8s-group-my-cluster-123-singleton


LogStore


config-operation-log


Logtail bileşenindeki alibaba-log-controller günlüklerini saklar. Bu LogStore'da toplama yapılandırmaları oluşturmanızı önermiyoruz. Bu LogStore'u silebilirsiniz. LogStore silindikten sonra alibaba-log-controller'ın operasyonel günlükleri artık toplanmaz. Bu LogStore, normal bir LogStore ile aynı şekilde faturalandırılır. Daha fazla bilgi için Pay-by-data-written billing konusuna bakın.


Yok

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

  1. 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
  2. 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

Önemli

Otomatik yükseltme, logtail-ds ve alibaba-log-controller içinde manuel olarak değiştirdiğiniz yapılandırmaları sıfırlar.

  1. Container Service Management Console'da oturum açın.

  2. Logs and Monitoring sekmesinde logtail-ds öğesini bulun ve ardından Upgrade öğesine tıklayın.

  3. Update iletişim kutusunda OK öğesine tıklayın.

Önemli

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

Önemli

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.

  1. Container Service Management Console'da oturum açın

  2. Workloads > DaemonSets yolunu izleyin.

    Not

    alibaba-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.

  3. Namespace değerini kube-system olarak ayarlayın ve ardından logtail-ds için Edit öğesine tıklayın.

  4. 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.

  5. Image Version için Select Image Version öğesine tıklayın.

  6. Image Version iletişim kutusunda en son sürüme tıklayın ve ardından OK öğesine tıklayın.

  7. Sayfanın sağ tarafında Update öğesine tıklayı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.

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.

Not

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.

  1. İş 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.

  2. 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
  3. 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

  1. Container Service Management Console'da oturum açın

  2. Logs and Monitoring sekmesinde logtail-ds öğesini bulun ve ardından Uninstall öğesine tıklayın.

  3. 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 deploy komutunu ç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.

Not

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