Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:LoongCollector Kurulumu

Son Güncelleme:Sep 30, 2026

LoongCollector, Simple Log Service (SLS) için günlük toplama aracıdır. Linux sunuculardan günlükleri toplamak için öncelikle LoongCollector'ı bu sunuculara yüklemeniz gerekir.

Sınırlamalar

Desteklenen Linux işletim sistemleri

  • Aşağıdaki 64 bitlik (x86-64) Linux işletim sistemleri desteklenir:

    • Alibaba Cloud Linux 2 ve 3

    • Anolis OS 7 ve 8

    • CentOS 6, 7 ve 8

    • Debian 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,04

    • glibc 2,6 veya sonraki sürümlerine dayalı diğer Linux işletim sistemleri

    • CPU, SSE4.2 ve AVX komut kümelerini desteklemelidir.

  • Aşağıdaki 64 bitlik ARM Linux işletim sistemleri 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

    • CPU mimarisi ARMv8.2-A veya sonraki bir sürüm olmalıdır.

Ön Koşullar

İzinler

Kök hesapla Alibaba Cloud konsoluna giriş yapmak, varsayılan olarak gerekli izinleri sağlar.

Bir RAM kullanıcısıysanız, SLS, ECS ve Operation Orchestration Service (OOS) kaynaklarını yönetmek için gerekli izinleri almak amacıyla kök hesap sahibinden aşağıdaki sistem ilkelerini talep edin.

  • AliyunLogFullAccess: SLS'yi yönetmek için tam izinler verir.

  • AliyunOOSFullAccess: OOS'u yönetmek için tam izinler verir. Otomatik LoongCollector kurulumu için OOS kullanmak gerektiğinde gereklidir.

  • AliyunECSFullAccess: ECS'i yönetmek için tam izinler verir. Cloud Assistant kullanarak LoongCollector'ı toplu olarak yüklemek için gereklidir.

Varsayılan sistem ilkeleri ihtiyaçlarınızı karşılamıyorsa, ayrıntılı erişim kontrolü için özel bir ilke oluşturabilirsiniz. Daha fazla bilgi için aşağıdaki örneğe bakın.

Resource alanında bulunan ${projectName} ifadesini projenizin adıyla değiştirin.
{
  "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": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListProject",
        "log:GetAcceleration",
        "log:ListDomains",
        "log:GetLogging",
        "log:ListTagResources"
      ],
      "Resource": [
        "acs:log:*:*:project/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:GetProject"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListLogStores",
        "log:GetLogStore",
        "log:GetLogStoreHistogram",
        "log:GetIndex",
        "log:CreateIndex",
        "log:UpdateIndex",
        "log:ListShards",
        "log:GetCursorOrData",
        "log:ListSavedSearch",
        "log:GetLogStoreLogs",
        "log:ListDashboard",
        "log:GetLogStoreContextLogs"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:*"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/logtailconfig/*",
        "acs:log:*:*:project/${projectName}/machinegroup/*"
      ]
    }
  ]
}

Bir proje oluşturun

Mevcut bir Projeniz yoksa temel bir Proje oluşturmak için şu adımları izleyin. Oluşturma yapılandırması hakkında ayrıntılar için bkz. Projeleri Yönetme.

SLS konsolu'na giriş yapın ve Create Project öğesini tıklayın. Aşağıdaki parametreleri yapılandırın ve diğer ayarlar için varsayılan değerleri koruyun:

  • Region: Günlüklerinizin kaynağına göre bir Alibaba Cloud bölgesi seçin. Bu ayar, proje oluşturulduktan sonra değiştirilemez.

  • Project Name: Proje için bir ad girin. Ad, seçilen Alibaba Cloud bölgesinde genel olarak benzersiz olmalı ve oluşturulduktan sonra değiştirilememelidir.

Bir Logstore oluşturun

Mevcut bir LogStore'unuz yoksa temel bir tane oluşturun. Yapılandırma ayrıntıları hakkında daha fazla bilgi için bkz. LogStore Yönetme.

  1. SLS konsolu'na giriş yapın. Proje listesinde istediğiniz projeyi tıklayın.

  2. Log Storage bölümünde, Logstores sekmesine gidin ve + simgesini tıklayın.

  3. Bir Logstore Name girin ve diğer parametreler için varsayılan değerleri koruyun.

Sunucu ağ gereksinimleri

  1. LoongCollector'ın yüklendiği sunucunun, veri yüklemeleri için 80 (HTTP) ve 443 (HTTPS) bağlantı noktalarında giden trafiğe izin vermesi gerekir.

  2. Sunucunun SLS uç noktasına bağlanabilmesi gerekir. Bağlantıyı doğrulamak için şu adımları izleyin:

    1. SLS konsolu'na giriş yapın. Proje listesinde istediğiniz projeyi tıklayın.

    2. Proje adının yanındaki image simgesini tıklayarak Project Overview sayfasına gidin.

    3. Endpoint bölümünde projenin uç nokta bilgilerini görüntüleyin. Ardından, aşağıdaki komuttaki değişkenleri değiştirip komutu çalıştırın.

      curl https://${project_name}.${endpoint}
    4. {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} gibi bir yanıt almanız ağ bağlantısının normal olduğunu gösterir. Aksi takdirde güvenlik duvarınızı, DNS yapılandırmanızı ve güvenlik grubu ayarlarınızı kontrol edin.

      İstek URL'sinde gerekli parametreler eksik olduğu için bu hata beklenir. Bu test yalnızca ağ bağlantısını doğrular ve eksiksiz bir istek URL'si kullanmaz.

Bir yükleme yöntemi seçin

Kurulum yöntemi

Senaryo

Aynı hesap ve bölge

Sunucu, projeyle aynı hesapta ve aynı bölgede bulunan bir ECS örneğidir.

Aynı hesap, farklı bölge

Sunucu, projeyle aynı hesapta ancak farklı bir bölgede bulunan bir ECS örneğidir.

Farklı hesaplar, aynı bölge

Sunucu, projeyle aynı bölgede ancak farklı bir hesapta bulunan bir ECS örneğidir.

Diğer cloud platformları veya şirket içi sunucular

  • Sunucu, bir şirket içi sunucu veya başka bir cloud sağlayıcısından gelen bir sunucu gibi bir Alibaba Cloud ECS örneği değildir.

  • Sunucu bir Alibaba Cloud ECS örneğidir ancak örnek ve proje farklı Alibaba Cloud hesaplarına aittir ve farklı bölgelerdedir. Bu durumda ECS örneği şirket içi bir sunucu olarak değerlendirilir.

Aynı hesap ve bölge

ECS örneğiniz ve projeniz aynı hesapta ve aynı bölgedeyse, tek tıkla kurulumu kullanabilirsiniz. SLS, OOS'u kullanarak kurulumu otomatikleştirir; bu nedenle örnekte manuel olarak oturum açmanız gerekmez.

Tek tıkla kurulum özelliği, SLS'nin veri toplama şablonlarına entegre edilmiştir. SLS, tek satırlı, çok satırlı ve regex tabanlı şablonlar gibi çeşitli metin günlük şablonları sunar. Bu şablonlar yalnızca kullandıkları işleme eklentileri bakımından farklılık gösterir. Bir şablon içinde işleme eklentileri ekleyebilir veya kaldırabilirsiniz. Toplamak istediğiniz günlüklerin özelliklerine göre bir şablon seçin veya herhangi bir metin günlük şablonu seçip günlük özelliklerinize göre işleme eklentilerini yapılandırın.

Yordam

  1. SLS konsolu'na giriş yapın. Proje listesinde istediğiniz projeyi tıklayın.

  2. Sol gezinme bölmesinde imageLog Storage > Logstores seçeneklerini belirleyin. İstediğiniz Logstore adının yanındaki image simgesini tıklayın.

  3. Data Collection öğesinin yanındaki image simgesini tıklayın, açılan iletişim kutusunda Single-line - Text Log içe aktarma şablonunu seçin ve Integrate Now öğesini tıklayın.

  4. Create Machine Group öğesini tıklayın. Projeyle aynı bölgede bulunan bir veya daha fazla ECS örneği seçin ve ardından Install and Create Machine Group öğesini tıklayın.

  5. Kurulumun tamamlanmasını bekleyin, bir ad girin ve ardından OK öğesini tıklayın. Kurulum başarısız olursa Recreate Installation Task öğesini tıklayıp ECS örneklerini yeniden seçin. Seçtiğiniz ECS örneklerinin projeyle aynı bölgede olduğundan emin olun.

  6. Next öğesini tıklayın. Heartbeat durumu FAIL ise Automatic Retry öğesini tıklayın ve durum OK olarak değişene kadar yaklaşık iki dakika bekleyin.

  7. Tek tıkla kurulum tamamlanır. Bir toplama yapılandırması oluşturmak için Next öğesini tıklayın.

Aynı hesap, farklı bölge

Sunucu bir Alibaba Cloud ECS örneğiyse ve örnek ile proje aynı Alibaba Cloud hesabına ait ancak farklı bölgelerdeyse, kurulum paketini manuel olarak indirmeniz ve kurulum komutunda internet veya transfer hızlandırma üzerinden veri iletimini kullanmanız gerekir.

Yordam

  1. Kurulum paketini indirin. Sunucuda indirme komutunu çalıştırın. Örnek kodda ${region_id} ifadesini cn-hangzhou ile değiştirebilirsiniz. İndirmeyi hızlandırmak için ${region_id} ifadesini ECS örneğinin bulunduğu bölgenin Bölge Kimliği ile değiştirin.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Bir iletim yöntemi seçin ve kurulum komutunu çalıştırın. ${region_id} ifadesini projenin bulunduğu bölgenin Bölge Kimliği ile değiştirin.

    • Internet: Bu yöntem, bölgeler arası dağıtımlar ve diğer cloud platformlarından veya şirket içi sunuculardan veri toplama gibi çoğu senaryo için uygundur. Ancak bant genişliği sınırlamalarına ve potansiyel kararsızlığa tabidir.

      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet
    • Transfer acceleration: Bu yöntem, Çin anakarasındaki bir bölgeden Çin anakarası dışındaki bir bölgeye gibi bölgeler arası veri iletimi için kullanılır. Content Delivery Network (CDN) kullanarak veri iletimini hızlandırır ve performansı artırır; bu sayede internet üzerindeki yüksek gecikme süresi ve kararsızlık önlenir. Ancak bu yöntem veri transfer ücretlerine tabidir.

      Kurulum komutunu çalıştırmadan önce proje için bölge transfer hızlandırma özelliğini etkinleştirmeniz gerekir.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration
  3. Başlatma durumunu kontrol edin. loongcollector is running döndürülürse aracının başlatıldığı anlamına gelir.

    sudo /etc/init.d/loongcollectord status
  4. Bir makine grubu yapılandırın. SLS, özel tanımlayıcıları keşfetmek ve ana bilgisayarlardaki LoongCollector ile kalp atışı bağlantıları kurmak için makine gruplarını kullanır.

    1. Sunucuda user-defined-test-1 gibi özel bir dizeyi özel tanımlayıcı dosyasına yazın. Bu dize sonraki bir adımda kullanılacaktır.

      # Write a custom string to the specified file. If the directory does not exist, create it manually. The file path and name are fixed by SLS and cannot be changed.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. SLS konsolu'na giriş yapın. Proje listesinde istediğiniz projeyi tıklayın.

    3. Sol gezinme bölmesinde imageResources > Machine Groups seçeneklerini belirleyin.

    4. Machine Groups öğesinin yanındaki image simgesini tıklayın ve ardından Create Machine Group öğesini tıklayın.

    5. Aşağıdaki parametreleri yapılandırın ve OK öğesini tıklayın.

      • Machine Group Name: Makine grubu için bir ad girin. Proje içinde benzersiz olmalı, 3 ila 128 karakter uzunluğunda olmalı, küçük harf veya rakamla başlamalı ve bitmeli; ayrıca yalnızca küçük harfler, rakamlar, kısa çizgiler (-) ve alt çizgiler (_) içermelidir.

      • Machine Group Identifier: Custom Identifier seçeneğini belirleyin.

      • Özel tanımlayıcı: Sunucudaki özel tanımlayıcı dosyasındaki özel dizeyle eşleşen tanımlayıcıyı girin. Örneğin, user-defined-test-1.

  5. Makine grubu oluşturulduktan sonra makine grubu listesinde hedef makine grubunu tıklayarak Heartbeat durumunu kontrol edin. Durum FAIL ise yaklaşık iki dakika bekleyin ve ardından manuel olarak yenileyin. OK durumu, makine grubunun başarıyla oluşturulduğu anlamına gelir.

  6. Kurulumdan sonra günlükleri toplamak için bir toplama yapılandırması oluşturun.

Aynı bölgede farklı hesaplar

Sunucunuz bir Alibaba Cloud ECS örneğiyse ve örnek ile proje aynı bölgedeyse ancak farklı Alibaba Cloud hesaplarına aitse, kurulum paketini manuel olarak indirmeniz gerekir. Kurulum komutunda dahili ağ iletim yöntemini kullanın ve bir kullanıcı kimliği yapılandırın.

Şu adımları izleyin:

  1. Kurulum paketini indirin. Sunucuda indirme komutunu çalıştırın. Örnek kodda ${region_id} ifadesini cn-hangzhou ile değiştirebilirsiniz. İndirmeyi hızlandırmak için Bölge Kimliği bölümüne bakın ve ${region_id} ifadesini ECS örneğinizin bulunduğu bölgeyle değiştirin.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Kurulum komutunu çalıştırın. ${region_id} ifadesini projenin Bölge Kimliği ile değiştirin.

    Bağlantı zaman aşımı oluşursa yanlış ${region_id} kullanmış olabilirsiniz. Dahili ağ, farklı bölgeler arasında bağlantı kuramaz. Bölge Kimliğini düzeltin ve kurulum komutunu tekrar çalıştırın.
    chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}
  3. Başlatma durumunu kontrol edin. Komutu çalıştırın. loongcollector is running döndürülürse başlatma başarılı olur.

    sudo /etc/init.d/loongcollectord status
  4. Kullanıcı kimliğini yapılandırın. Kullanıcı kimliği dosyası, projeye sahip olan kök Alibaba Cloud hesabının kimliğini içerir. Bu kimlik, hesabın bu sunucudan günlüklere erişme ve bunları toplama iznine sahip olduğunu gösterir.

    Kullanıcı kimliğini yalnızca başka bir hesaba ait ECS örneklerinden, kendi kendine yönetilen sunuculardan veya diğer cloud sağlayıcılarının sunucularından günlük toplarken yapılandırmanız gerekir. Birden çok hesap aynı sunucudan günlük topluyorsa o sunucuda birden çok kullanıcı kimliği dosyası oluşturabilirsiniz.
    1. SLS konsolu'na giriş yapın. Sağ üst köşedeki profil resminizin üzerine gelin. Açılan sekmede hesap kimliğini görüntüleyin ve kopyalayın. Kök hesap kimliğini kopyaladığınızdan emin olun.

    2. LoongCollector'ın yüklü olduğu sunucuda bir kullanıcı kimliği dosyası oluşturun. Dosya adı olarak kök hesap kimliğini kullanın.

      touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # If the /etc/ilogtail/users directory does not exist, create it manually. The user ID file requires only a filename and no file extension.
  5. Bir makine grubu yapılandırın. SLS, özel tanımlayıcıyı keşfetmek ve ana bilgisayardaki LoongCollector ile kalp atışı bağlantısı kurmak için makine grubunu kullanır.

    1. Sunucuda user-defined-test-1 özel dizesini özel tanımlayıcı dosyasına yazın. Bu dize sonraki bir adımda kullanılır.

      # Write a custom string to the specified file. If the directory does not exist, create it manually.
      # The file path and name are fixed by SLS and cannot be changed.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. SLS konsolu'na giriş yapın. Proje listesinde hedef projeyi tıklayın.

    3. image Resources öğesini tıklayın ve ardından Machine Groups öğesini tıklayın.

    4. Machine Groups listesinin sağında image simgesini tıklayın ve ardından Create Machine Group öğesini tıklayın. Alternatif olarak sağ üst köşedeki dört kareli simgeyi tıklayabilir ve açılır menüden Create Machine Group seçeneğini belirleyebilirsiniz.

    5. Aşağıdaki ayarları yapılandırın ve OK öğesini tıklayın.

      • Makine Grubu Adı ayarlayın: Ad, proje içinde benzersiz olmalıdır. Ad 3 ila 128 karakter uzunluğunda olmalı, küçük harf veya rakamla başlamalı ve bitmeli; ayrıca yalnızca küçük harfler, rakamlar, kısa çizgiler (-) ve alt çizgiler (_) içermelidir.

      • Machine Group Identifier: ayarını Custom Identifier olarak belirleyin.

      • Özel Tanımlayıcı: Yapılandırdığınız özel tanımlayıcıyı girin. Bu tanımlayıcı, sunucudaki özel tanımlayıcı dosyasındaki özel dizeyle aynı olmalıdır. Bu örnekte tanımlayıcı user-defined-test-1 değerindedir.

  6. Makine grubu oluşturulduktan sonra listeden hedef makine grubunu tıklayın. Makine grubu durumu bölümünde Heartbeat durumunu kontrol edin. Durum FAIL ise yaklaşık iki dakika bekleyin ve ardından sayfayı yenileyin. Kalp atışı durumu OK ise makine grubu başarıyla oluşturulmuştur.

  7. Kurulum tamamlandıktan sonra günlükleri toplamak için bir toplama yapılandırması oluşturmanız gerekir.

Diğer cloud veya şirket içi sunucular

Sunucunuz başka bir cloud platformunda barındırılıyorsa veya bir şirket içi sunucuyse, kurulum paketini manuel olarak indirmeniz gerekir. Kurulum komutunda public network veya transfer hızlandırma yöntemini kullanın ve bir kullanıcı kimliği yapılandırın. Bir Alibaba Cloud ECS örneği de örnek ve proje farklı Alibaba Cloud hesaplarına aitse veya farklı bölgelerdeyse şirket içi bir sunucu olarak kabul edilir.

Not

Sunucu kullanım sınırlamaları için bkz. Desteklenen Linux dağıtımları.

Yordam

  1. Kurulum paketini indirin. Sunucunuzda indirme komutunu çalıştırın. Örnek kodda ${region_id} ifadesini cn-hangzhou ile değiştirebilirsiniz. Paket indirmeyi hızlandırmak için Bölge Kimliği bölümüne bakın ve ${region_id} ifadesini ECS örneğinizin bölge kimliğiyle değiştirin.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Bir transfer yöntemi seçin ve kurulum komutunu çalıştırın. ${region_id} ifadesini projenizin bulunduğu bölgenin Bölge Kimliği ile değiştirin.

    • Public network: Bu yöntem, bölgeler arası transferler ve diğer cloudlardaki veya şirket içi sunucular dahil çoğu senaryo için çalışır. Ancak bant genişliği sınırlamalarına ve potansiyel kararsızlığa tabidir.

      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet
    • Transfer acceleration: Çin anakarasından yurtdışı bölgelere gibi bölgeler arası transferler için bunu kullanın. Performansı artırmak ve public network'ün yüksek gecikme süresi ve kararsızlığını önlemek için CDN hızlandırmasını kullanır. Bu trafik ek ücrete tabidir.

      Kurulum komutunu çalıştırmadan önce projeniz için bölge günlük transfer hızlandırma özelliğini etkinleştirin.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration
  3. Başlatma durumunu kontrol edin. Komutu çalıştırın. loongcollector is running döndürülürse başlatma başarılı olur.

    sudo /etc/init.d/loongcollectord status
  4. Kullanıcı kimliğini yapılandırın. Kullanıcı kimliği dosyası, projeye sahip olan Alibaba Cloud kök hesabının kimliğini içerir. Bu kimlik, hesabın bu sunucudan günlüklere erişme ve bunları toplama iznine sahip olduğunu doğrular.

    Kullanıcı kimliğini yalnızca hesabınıza ait olmayan bir ECS örneğinden, şirket içi bir sunucudan veya başka bir cloud sağlayıcısının sunucusundan günlük toplarken yapılandırın. Birden çok hesap aynı sunucudan günlük topluyorsa üzerinde birden çok kullanıcı kimliği dosyası oluşturabilirsiniz.
    1. SLS konsolu'na giriş yapın. Sağ üst köşedeki kullanıcı avatarınızın üzerine gelin. Açılan sekmede hesap kimliğini görüntüleyin ve kopyalayın. Kök hesap kimliğini kopyaladığınızdan emin olun.

    2. LoongCollector'ın yüklü olduğu sunucuda bir kullanıcı kimliği dosyası oluşturun. Dosya adı olarak kök hesap kimliğini kullanın.

      touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # If the /etc/ilogtail/users directory does not exist, create it manually. The user ID file only needs a filename and does not require a file extension.
  5. Bir makine grubu yapılandırın. SLS, özel tanımlayıcıyı keşfetmek ve ana bilgisayardaki LoongCollector ile kalp atışı bağlantısı kurmak için makine grubunu kullanır.

    1. Sunucuda user-defined-test-1 özel dizesini özel tanımlayıcı dosyasına yazın. Bu dize sonraki bir adımda kullanılacaktır.

      # Write the custom string to the specified file. If the directory does not exist, create it manually. The file path and name are fixed by SLS and cannot be customized.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. SLS konsolu'na giriş yapın. Proje listesinde hedef projeyi tıklayın.

    3. image Resources öğesini tıklayın ve ardından Machine Groups öğesini tıklayın.

    4. Machine Groups öğesinin sağında image simgesini tıklayın ve ardından Create Machine Group öğesini tıklayın.

    5. Aşağıdaki ayarları yapılandırın ve OK öğesini tıklayın.

      • Makine grubu adı: Ad, proje içinde benzersiz olmalıdır. 3 ila 128 karakter uzunluğunda olmalı, küçük harf veya rakamla başlamalı ve bitmeli; ayrıca yalnızca küçük harfler, rakamlar, kısa çizgiler (-) ve alt çizgiler (_) içermelidir.

      • Machine Group Identifier: Custom Identifier seçeneğini belirleyin.

      • Özel Tanımlayıcı: Yapılandırılan özel tanımlayıcıyı girin. Sunucudaki özel tanımlayıcı dosyasındaki özel dizeyle eşleşmelidir. Bu örnekte değer user-defined-test-1 şeklindedir.

  6. Makine grubu oluşturulduktan sonra makine grubu listesinde onu tıklayın. Makine grubu durumu panelinde Heartbeat durumunu kontrol edin. Durum FAIL ise yaklaşık iki dakika bekleyin ve sayfayı yenileyin. OK durumu, oluşturma işleminin başarılı olduğu anlamına gelir.

  7. Kurulumdan sonra günlükleri toplamak için bir toplama yapılandırması oluşturun.

LoongCollector'ı toplu olarak yükleme

  • Otomatik kurulum özelliği, örnekler ve proje aynı hesapta ve bölgedeyse birden fazla ECS örneği seçmeyi destekler.

  • Diğer senaryolarda geçici görevler olarak komutları çalıştırmak için ECS Cloud Assistant kullanın. Bu sayede LoongCollector kurulum komutlarını ECS örneklerinde toplu olarak çalıştırabilirsiniz.

    İndirme ve kurulum komutları için önceden açıklanan kurulum senaryolarına bakın. ECS Cloud Assistant'ın nasıl kullanılacağını öğrenmek için bkz. Komut oluşturma ve çalıştırma.

Güncelleme ve geri alma

Önemli

LoongCollector güncelleme sırasında çalışmayı durdurur ve güncelleme tamamlandıktan sonra otomatik olarak başlar. Güncelleme yalnızca gerekli dosyaların üzerine yazar. Güncelleme sırasında hiçbir günlüğün kaybolmamasını sağlamak için yapılandırma dosyaları ve kontrol noktası dosyaları korunur.

LoongCollector'ı güncelleme veya Logtail'i LoongCollector'a yükseltme

  1. En son kurulum paketini almak için sunucuda indirme komutunu çalıştırın. Örnek kodda ${region_id} ifadesini cn-hangzhou gibi bir bölge kimliğiyle değiştirin. Paket indirmeyi hızlandırmak için Bölgeler bölümüne bakın ve ${region_id} ifadesini ECS örneğinizin bulunduğu bölgeyle değiştirin.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Güncelleme komutunu çalıştırın. Güncellemek için upgrade komutunu kullanın. install komutunu kullanırsanız üzerine yazarak kurulum yapılır ve orijinal yapılandırmanız kaybolur.

    chmod +x loongcollector.sh; sudo ./loongcollector.sh upgrade;
  3. Aşağıdaki bilgiler görüntülenirse güncelleme başarılı olur.

    Upgrade loongcollector files successfully.
    Starting loongcollector ...
    Upgrade loongcollector successfully.

LoongCollector'ı Logtail'e geri alma

Not

logtail.sh betiğini tekrar indirin. Betiğin önceki sürümünü kullanmayın.

  1. Kurulum paketini almak için sunucuda indirme komutunu çalıştırın. Örnek kodda ${region_id} ifadesini cn-hangzhou gibi bir bölge kimliğiyle değiştirin. Paket indirmeyi hızlandırmak için Bölgeler bölümüne bakın ve ${region_id} ifadesini ECS örneğinizin bulunduğu bölgeyle değiştirin.

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
  2. Geri alma komutunu çalıştırın. 1.8.7 gibi bir sürüm belirtmek için yorumlanmış satıra bakın ve sürüm numarasını gerektiği gibi değiştirin.

    chmod +x logtail.sh; sudo ./logtail.sh upgrade;
    #chmod +x logtail.sh; sudo ./logtail.sh upgrade -v 1.8.7;

Belirli bir sürümü yükleme

Belirli bir sürümü yüklemek için -v parametresini kullanın. Aşağıdaki komutlara bakın ve sürüm numarasını gerektiği gibi değiştirin.

  • LoongCollector

    chmod +x loongcollector.sh; sudo ./loongcollector.sh install ${region_id} -v 3.2.6;
  • Logtail

    chmod +x logtail.sh; sudo ./logtail.sh install ${region_id} -v 1.8.7;

LoongCollector'ı kaldırma

  1. Örnek kodda ${region_id} ifadesini cn-hangzhou gibi bir bölge kimliğiyle değiştirin. Yürütmeyi hızlandırmak için Bölgeler bölümüne bakın ve ${region_id} ifadesini ECS örneğinizin bulunduğu bölgeyle değiştirin.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Kaldırma komutunu çalıştırın.

    chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

Sıkça Sorulan Sorular

İnternet bağlantısı olmayan bir sunucuya LoongCollector yükleme

  1. LoongCollector yüklemek istediğiniz sunucuda sistem mimarisini kontrol etmek için uname -m komutunu çalıştırın. Ardından internet erişimi olan bir sunucuda ilgili indirme komutunu çalıştırın. ${region_id} ifadesini projenizin Bölge Kimliği ile değiştirin.

    • ARM mimarisi:

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;
    • x86-64 mimarisi:

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;
  2. İndirilen kurulum betiğini ve paketini LoongCollector yüklemek istediğiniz sunucuya kopyalayın. Ardından aşağıdaki komutu çalıştırın. ${region_id} ifadesini projenizin Bölge Kimliği ile değiştirin.

    chmod +x loongcollector.sh; ./loongcollector.sh install-local ${region_id}-internet
  3. Durum komutunu çalıştırın. Çıktı loongcollector is running ise LoongCollector başarıyla başlatılmıştır.

    sudo /etc/init.d/loongcollectord status
  4. Sunucu internete erişemediği için ayrıca bir proxy yapılandırarak bağlantı kurmanız gerekir.

İnternet bağlantısı olmayan bir sunucuda LoongCollector'ı güncelleme

  1. LoongCollector'ı güncellemek istediğiniz sunucuda sistem mimarisini kontrol etmek için uname -m komutunu çalıştırın. Ardından internet erişimi olan bir sunucuda ilgili komutu çalıştırın. ${region_id} ifadesini projenizin bölgesi ile değiştirin.

    • ARM mimarisi:

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;
    • x86-64 mimarisi:

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;
  2. Kurulum betiğini ve paketini LoongCollector'ı güncellemek istediğiniz sunucuya kopyalayın. Ardından aşağıdaki komutu çalıştırın:

    chmod +x loongcollector.sh;./loongcollector.sh upgrade-local;

Tek tıkla kurulum başarısız oluyor

Otomatik kurulum yalnızca ECS örneği ve proje aynı hesapta ve bölgedeyse desteklenir. Durumunuz bu değilse farklı bir kurulum yöntemi kullanın. Kurulumunuz bu gereksinimi karşılıyorsa izin ve ağ gereksinimlerini karşılayıp karşılamadığınızı kontrol edin. Daha fazla bilgi için bkz. Ön Koşullar.

Eksik veya başarısız kalp atışını çözme

Kalp atışı durumu FAIL ise bunun nedeni ilk bağlantının zaman alması olabilir. Yaklaşık iki dakika bekleyin ve ardından durumu yenileyin. Durum hala FAIL ise sorun gidermek için şu adımları izleyin:

  • Sunucu ile SLS projesi arasındaki ilişkiyi onaylayın. Kurulum yordamı bu ilişkiye göre değişir.

    • Yanlış yordamı kullandıysanız sunucuda chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; komutunu çalıştırarak kaldırma işlemi yapın. Ardından doğru yordamı kullanarak kurulumu tekrarlayın.

  • Doğru yordamı kullandıysanız ancak kalp atışı durumu hala FAIL ise LoongCollector'ın yüklü olduğu sunucuyu kontrol edin. /usr/local/ilogtail/ilogtail_config.json dosyasındaki region değerinin SLS projenizin Bölge Kimliği ile eşleştiğini doğrulayın.

    • Eşleşmiyorsa kurulum komutundaki ${region_id} ifadesini doğru Bölge Kimliğiyle değiştirin ve komutu tekrar çalıştırın. LoongCollector dosyayı güncelleyecektir.

      Bu eylem mevcut kurulumun üzerine yazar ve orijinal yapılandırmalarınızı siler. Bu yöntemi zaten toplama için yapılandırılmış sunucularda dikkatli kullanın.
    • Bilgiler doğruysa veya yeniden yükledikten sonra kalp atışı durumu hala FAIL ise sonraki adıma geçin.

  • Yordamınız bir kullanıcı kimliği dosyası gerektiren hesaplar arası bir senaryo içeriyorsa aşağıdakileri kontrol edin:

    • Kullanıcı kimliği kök hesabın kimliği olmalıdır. Değilse değiştirin.

    • Kök hesap kimliği, ECS sunucusuna sahip olan hesaba değil, SLS projesine sahip olan hesaba ait olmalıdır.

  • SLS konsolunda makine grubu için yapılandırılan özel tanımlayıcıyı kontrol edin. Sunucudaki özel tanımlayıcı dosyasının içeriğiyle eşleştiğinden emin olun. Eşleşmiyorsa konsol yapılandırmasını veya dosyayı değiştirerek ikisini aynı hale getirin.

  • Kalp atışı durumu hala FAIL ise ağ gereksinimlerini karşılayıp karşılamadığınızı kontrol edin. Daha fazla bilgi için bkz. Ön Koşullar.

İlgili Başvurular

Bölgeler

  1. SLS konsolu'na giriş yapın. Proje listesinde hedef projeyi tıklayın.

  2. Proje adının sağındaki image simgesini tıklayarak proje genel bakış sayfasına gidin.

  3. Temel Bilgiler bölümünde mevcut projenin bölge adını görüntüleyin. İlgili Bölge Kimliği için aşağıdaki tabloya bakın.

    Bölge, cloud kaynakları için fiziksel bir veri merkezinin coğrafi konumunu temsil eder . Bölge Kimliği, bir cloud hizmet bölgesi için benzersiz bir tanımlayıcıdır.

Bölge ve Bölge Kimliği eşleme tablosu


Bölge adı


Bölge Kimliği


Çin (Qingdao)


cn-qingdao


Çin (Pekin)


cn-beijing


Çin (Zhangjiakou)


cn-zhangjiakou


Çin (Hohhot)


cn-huhehaote


Çin (Ulanqab)


cn-wulanchabu


Çin (Hangzhou)


cn-hangzhou


Çin (Şanghay)


cn-shanghai


Çin (Nanjing) - Yerel Bölge - Kullanımdan Kaldırılıyor


cn-nanjing


Çin (Fuzhou) - Yerel Bölge - Kullanımdan Kaldırılıyor


cn-fuzhou


Çin (Shenzhen)


cn-shenzhen


Çin (Heyuan)


cn-heyuan


Çin (Guangzhou)


cn-guangzhou


Filipinler (Manila)


ap-southeast-6


Güney Kore (Seul)


ap-northeast-2


Malezya (Kuala Lumpur)


ap-southeast-3


Japonya (Tokyo)


ap-northeast-1


Tayland (Bangkok)


ap-southeast-7


Çin (Chengdu)


cn-chengdu


Singapur


ap-southeast-1


Endonezya (Cakarta)


ap-southeast-5


Çin (Hong Kong)


cn-hongkong


Almanya (Frankfurt)


eu-central-1


ABD (Virginia)


us-east-1


ABD (Silikon Vadisi)


us-west-1


Birleşik Krallık (Londra)


eu-west-1


BAE (Dubai)


me-east-1


Suudi Arabistan (Riyad)


me-central-1

LoongCollector ağ transfer türleri

Uç nokta, SLS için erişim alan adıdır. Bir projeye ve günlük verilerine erişmek için kullanılan URL'dir. Uç nokta, projenin bulunduğu bölgeye özeldir. SLS özel uç noktalar, public uç noktalar ve transfer hızlandırma uç noktaları sağlar. Uç noktaları aşağıdaki gibi görüntüleyin:

  1. SLS konsolu'na giriş yapın. Proje listesinde hedef projeyi tıklayın.

  2. Proje adının sağındaki image simgesini tıklayarak proje genel bakış sayfasına gidin.

  3. Erişim Uç Noktaları bölümünde mevcut projenin uç nokta bilgilerini görüntüleyin. Farklı ağ transfer yöntemleri farklı uç noktalara karşılık gelir. Doğru ağ transfer yöntemini seçmek daha hızlı ve kararlı günlük verisi iletimi sağlamaya yardımcı olur.

Ağ türü

İlgili uç nokta türü

Açıklama

Senaryolar

Alibaba Cloud dahili ağı

Özel uç nokta

Alibaba Cloud dahili ağı gigabit paylaşımlı bir ağdır. Günlük verilerini dahili ağ üzerinden aktarmak, public internete göre daha hızlı ve kararlıdır. Dahili ağ VPC ve klasik ağı içerir.

ECS örneği ve SLS projesi aynı bölgededir veya şirket içi sunucunuzu dahili ağa bağladınız.

Not

ECS örneğinizle aynı bölgede bir SLS projesi oluşturun. Bu sayede public bant genişliği tüketmeden Alibaba Cloud dahili ağı üzerinden ECS örneğinden günlükleri toplayabilirsiniz.

Public internet

Public uç nokta

Günlük verilerini public internet üzerinden aktardığınızda veri toplama hızı ve kararlılığı bant genişliği sınırlamaları, ağ titremesi, gecikme süresi ve paket kaybından etkilenebilir.

Verileri aşağıdaki iki durumda public internet üzerinden aktarın.

  • ECS örneği ve SLS projesi farklı bölgelerdedir.

  • Sunucu başka bir cloud sağlayıcısında veya şirket içi veri merkezinizde barındırılmaktadır.

Transfer hızlandırma

Transfer hızlandırma uç noktası

Alibaba Cloud CDN kenar düğümlerini kullanarak günlük toplamayı hızlandırmak, public internet üzerinden toplamaya kıyasla ağ gecikme süresi ve kararlılığı açısından önemli avantajlar sunar ancak trafik ek ücrete tabidir.

Uygulama sunucunuz ve SLS projeniz sırasıyla Çin ve uluslararası bölgelerde bulunuyorsa verileri public internet üzerinden aktarmak yüksek gecikme süresi ve kararsızlığa neden olabilir. Bu durumda verileri aktarmak için transfer hızlandırmayı kullanın. Daha fazla bilgi için bkz. Transfer hızlandırma.