SpitfireYük Testi ve APMYenilikler

Spitfire Collector: uygulamalar ve sunucu ölçümleri

Spitfire Collector sunucuya bir kez kurulur ve tek hizmet olarak iki iş yapar: sunucunun CPU, bellek, disk, ağ ve süreç ölçümlerini Sunucular Spitfire'da: /servers sayfasına gönderir (Sunucu ölçümleri) ve sunucudaki Java, .NET, .NET Framework (yalnız Windows), Node.js, Python ve PHP uygulamalarını bulup trace'lerini açar. Ayrı bir Sunucu Collector'ı gerekmez; eskisi varsa kurulum onu devralıp kaldırır (geçiş).

Gelen port açmaz, dakikada bir Spitfire'a rapor verir ve isteklerinizi o cevapta alır. Spitfire'a ulaşamazsa veriyi diske yazmadan bırakır, uygulamayı bekletmez. Kaldırınca uygulamalara eklediği her ayarı geri alır. Kurulumu çalışma alanı yöneticisi yapar.

Hızlı kurulum

  1. APM → Collector'lar → Uygulama Collector'ları sayfasında sağ üstteki Collector kura basın. Pencere tarayıcınızın işletim sistemi seçili, yeni bir alıcı anahtarıyla (sfotlp_) açılır. Sunucu başka bir işletim sistemindeyse üstteki düğmesine basın.
  2. Gösterilen komutu kopyalayıp sunucuda çalıştırın (Linux, Windows, macOS). Windows ve macOS'ta kurulum dosyasını indirip Bağlantı kodunu yapıştırmak da olur.
  3. Pencereyi açık bırakın. Birkaç saniye sonra alttaki panel Collector rapor verdi der ve bulduğu uygulamaları listeler. Trace'i açılan uygulamanın ilk span'i gelince panel servisin APM sayfasına bağlantı verir.

Varsayılanlar: tüm runtime'lar, ortam prod, örnekleme %10, otomatik trace açık, yeniden başlatma yok.

Dikkat

Anahtar yalnız bu pencerede, komutun ve bağlantı kodunun içinde görünür. Kurulum bitmeden pencereyi kapatmayın; yeni pencere yeni anahtar oluşturur.

En sık karşılaşılan hata: tarayıcıda Spitfire'ı localhost ile açıp komutu öyle kopyalamak. Pencere bunu uyarır; Gelişmiş ayarlarda sunucunun Spitfire'a ulaştığı adresi yazın.

Gelişmiş ayarlar

Kopyalamadan önce Gelişmiş ayarlarda şunları değiştirebilirsiniz; komut siz yazdıkça güncellenir:

  • Otomatik trace ve Uygulamaları şimdi yeniden başlat (yeniden başlatma onayı).
  • Ortam, Örnekleme (0.1 = isteklerin %10'u), İzlenecek runtime'lar.
  • Spitfire adresi, mevcut bir sfotlp_ anahtarı, Tower adresi ve sfcol_ anahtarı, HTTPS proxy, CA dosyasının sunucudaki tam yolu.
  • Kapsam: hariç tutulacak uygulamalar, servis adları, modüller, onay listesi (Kapsam).

Otomatik trace

Otomatik trace (komutta --auto, collector.json'da "autoTrace": true) systemd, Windows service, IIS, launchd ya da php-fpm ile çalışan her uygulamada trace'i ilk bulduğunda bir kez açar ve uygulamaya adından bir service.name verir.

  • Trace uygulamanın bir sonraki yeniden başlatılmasında (deploy, reboot) başlar. Onay olmadan hiçbir şey yeniden başlatılmaz. Hemen başlasın isterseniz Uygulamaları şimdi yeniden başlatı işaretleyin (--restart, "autoRestart": true) ya da panelde Şimdi yeniden başlata basın.
  • Docker, Kubernetes ve elle başlatılan uygulamalar otomatik açılmaz; Collector sayfası kopyala-yapıştır adımlarını verir.
  • Spitfire'da kapattığınız uygulama kapalı kalır. Süresi dolmuş (salt okunur) lisansta otomatik trace değişiklik yapmaz.

Canlı panel

Kurulum penceresinin altındaki panel her satırda bir anahtarla uygulamayı açıp kapatır. Tümünü izle kapalı olanları açar. Restart bekliyor satırları sunucuda çalıştırılacak komutu ve Şimdi yeniden başlat düğmesini gösterir.

Linux

Gerekenler: systemd, root ya da sudo, curl (ya da wget), amd64 veya arm64.

  1. Sunucuda sudo yetkisi olan bir kullanıcıyla terminal açın.
  2. Kurulum penceresindeki komutu yapıştırıp Enter'a basın. Komut şu biçimdedir:
bash
curl -fsSL https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.sh | \
  sudo bash -s -- --from https://spitfire.sirketiniz.com \
    --token sfotlp_... \
    --auto
  1. Komut gereksinimleri kontrol eder, Collector'ı kurar, bağlantıyı dener ve hizmeti başlatır.
  2. Başarı kontrolü: aşağıdaki komut OK: connected to ... satırını ve altında Server metrics: on, as "SUNUCU-ADI", to Spitfire (Servers). satırını yazmalı (Tower ile: to the Tower ... (Servers)).
bash
sudo /usr/local/bin/spitfire-apm-collector check
  1. Hizmetin durumu (active (running) yazmalı):
bash
sudo systemctl status spitfire-apm-collector --no-pager
  1. Yaklaşık 1 dakika içinde sunucu Sunucular Spitfire'da: /servers sayfasında görünür.

Dosyalar: ayar /etc/spitfire-apm/collector.json, sunucu ölçümleri parçası /opt/spitfire-apm/host/, OpenTelemetry kitleri /opt/spitfire-apm/kits, durum /var/lib/spitfire-apm, log /var/log/spitfire-apm-collector.log.

Windows

Gerekenler: 64-bit Windows Server 2016+ ya da Windows 10+, yönetici hesabı, PowerShell 5.1+.

Kurulum dosyasıyla

  1. Kurulum penceresinde Kurulum dosyası (msi/exe) sekmesini seçin.
  2. spitfire-apm-collector-setup.exe (ya da spitfire-apm-collector.msi) dosyasını indirin, gerekirse sunucuya kopyalayın.
  3. Bağlantı kodunun yanındaki kopyala düğmesine basın (kod SFAPM1. ile başlar).
  4. exe'ye çift tıklayın, yönetici iznini onaylayın. Bağlantı kodu sayfası panodan dolar; dolmazsa kodu yapıştırın. İleri ile bitirin.
  5. Başarı kontrolü için PowerShell'i Yönetici olarak çalıştır ile açın:
powershell
& "$env:ProgramFiles\Spitfire\APM\spitfire-apm-collector.exe" check -config "$env:ProgramData\Spitfire\APM\collector.json"; Get-Service SpitfireAPMCollector

OK: connected to ... satırını, altında Server metrics: on, as "SUNUCU-ADI", to Spitfire (Servers). satırını ve hizmetin Running durumunu görmelisiniz. Yaklaşık 1 dakika içinde sunucu Sunucular Spitfire'da: /servers sayfasında görünür.

Yazılım dağıtımı için msi ile sessiz kurulum (exe için /S /CODE=SFAPM1....):

powershell
msiexec /i spitfire-apm-collector.msi /qn CODE=SFAPM1....

Komutla

  1. PowerShell'i Yönetici olarak çalıştır ile açın.
  2. Kurulum penceresindeki komutu yapıştırıp Enter'a basın. Komut şu biçimdedir:
powershell
& ([scriptblock]::Create((Invoke-RestMethod -UseBasicParsing 'https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.ps1'))) `
    -From 'https://spitfire.sirketiniz.com' `
    -Token 'sfotlp_...' `
    -Auto
  1. Başarı kontrolü yukarıdaki check komutudur.

Hizmet SpitfireAPMCollector adıyla kurulur, Hizmetler'de Spitfire Collector olarak görünür. Ayar ve log C:\ProgramData\Spitfire\APM\ klasöründedir (collector.json, collector.log).

macOS

Gerekenler: macOS 12+, yönetici parolası, Intel ya da Apple Silicon.

Kurulum dosyasıyla

  1. Kurulum penceresinde Kurulum dosyası (dmg) sekmesini seçin ve spitfire-apm-collector.dmg dosyasını indirin.
  2. Bağlantı kodunun yanındaki kopyala düğmesine basın.
  3. dmg'yi açıp Spitfire Collector'a çift tıklayın, Kur'a basın. Kod panodan okunur; okunmazsa sorar, yapıştırın. Yönetici parolanızla bitirin.
  4. Başarı kontrolü (Terminal): OK: connected to ... ve Server metrics: on, as "SUNUCU-ADI", to Spitfire (Servers). satırlarını görmelisiniz.
bash
sudo /usr/local/bin/spitfire-apm-collector check
  1. Yaklaşık 1 dakika içinde sunucu Sunucular Spitfire'da: /servers sayfasında görünür.

Komutla

Linux'taki komutun aynısıdır; kurulum penceresi macOS seçilince doğrusunu verir. Başarı kontrolü yukarıdaki check komutu; hizmet için şu komut state = running yazmalı:

bash
sudo launchctl print system/tr.spitfire.apm-collector | grep state

Dosyalar: ayar /Library/Spitfire/APM/collector.json, sunucu ölçümleri parçası /Library/Spitfire/APM/host/, log /Library/Logs/spitfire-apm-collector.log.

Sunucu ölçümleri

Aynı hizmet ayrı bir parçayla CPU, bellek, disk, dosya sistemi, ağ, servis ve en yoğun süreç ölçümlerini toplar. Parça durursa hizmet onu yeniden başlatır; APM tarafı etkilenmez.

  • Tower yoksa ölçümler aynı sfotlp_ anahtarıyla doğrudan Spitfire'a gider. Bunun için Tower'lar ve metrikler Spitfire'da: /towers sayfasında Metrikleri topla ve sakla açık olmalı (Metrikleri açmak). Lisansınızın sunucu sınırı geçerlidir.
  • Tower varsa komuta --tower http://tower:4318 --tower-token sfcol_... (Windows: -Tower ve -TowerToken) ekleyin.

Ayarlar komuta eklenir; verilmeyen ayar korunur:

Linux / macOS Windows Anlamı
--host-name AD -HostName AD Sunucunun Sunucular'daki adı (varsayılan bilgisayarın adı)
--host-interval SN -HostInterval SN Ölçüm aralığı, 10–300 saniye (varsayılan 30)
--host-processes N -HostProcesses N Tutulan en yoğun süreç sayısı: 10, 25 ya da 50
--host-binary DOSYA -HostBinary DOSYA İnternetsiz sunucu: parçayı indirmek yerine bu dosyadan kur
--modules host,processes,apm,docker,iis -Modules ... Çalışacak modüller; host ve processes sunucu ölçümleridir

Yalnız APM isterseniz --modules apm (Windows: -Modules apm) verin.

Kontrol: check komutunun ikinci satırı ölçümlerin durumunu söyler.

Satır Anlamı
Server metrics: on, as "AD", to Spitfire (Servers). Çalışıyor; sunucu yaklaşık 1 dakikada Sunucular'da
Server metrics: off (modules). Modüllerde kapattınız
Server metrics: not installed here: ... Parça bu kurulumda yok: kurulum komutunu yeniden çalıştırın
Server metrics: cannot start (see the log). Parça başlamıyor: nedeni Collector log'undadır

Eski Collector'lardan geçiş

Kurulum komutunu (ya da Windows'ta kurulum dosyasını) olduğu gibi çalıştırın. Eski Sunucu Collector'ı (spitfire-collector hizmeti, Linux'ta /etc/spitfire/collector.env) varsa kurulum onun adını, Tower'ını, ölçüm aralığını ve süreç sayısını devralır, yeni hizmet bağlandıktan sonra eskisini kaldırır. Sunucu Sunucular'da iki kez sayılmaz. APM Collector zaten kuruluysa yerinde güncellenir, ayarları korunur. Komutta verdiğiniz ayar (--host-name gibi) eskisinden gelenin önüne geçer.

Kontrol (Linux):

bash
systemctl is-active spitfire-collector >/dev/null 2>&1 && echo "Eski hizmet hâlâ var" || echo "OK: eski Sunucu Collector'ı kaldırıldı"; sudo /usr/local/bin/spitfire-apm-collector check

Windows (yönetici PowerShell):

powershell
if (Get-Service spitfire-collector -ErrorAction SilentlyContinue) { 'Eski hizmet hâlâ var' } else { "OK: eski Sunucu Collector'ı kaldırıldı" }; Get-Service SpitfireAPMCollector

Eski hizmet hâlâ duruyorsa yeni hizmet henüz bağlanamamıştır: check çıktısındaki NOT CONNECTED satırına bakın.

Trace'i açma

Otomatik trace bunu systemd, launchd, Windows hizmeti, IIS ve PHP-FPM uygulamalarında zaten yapar. Elle açmak için:

  1. Uygulama Collector'ları Spitfire'da: /apm/app-collectors sayfasında sunucuya tıklayın.
  2. Bulunan uygulamalar tablosunda uygulamanın satırındaki Trace'i aça basın.
  3. service.name önerilen adla gelir; gerekirse değiştirin. Ortam ve örnekleme boşsa kurulumdaki değerler geçer.
  4. Hemen yeniden başlasın isterseniz şimdi yeniden başlatılsın kutusunu işaretleyin. İşaretlemezseniz durum Restart bekliyor olur ve çalıştırmanız gereken komut satırda görünür.
  5. Trace'i aça basın. İstek en geç bir dakika içinde Collector'a ulaşır.
  6. Kontrol: uygulama yeniden başlayınca durum Trace açık olur ve trace'ler APM → Servisler → Servisler Spitfire'da: /apm/services sayfasına düşer.

Kapatmak için aynı satırda Değiştir › Trace'i kapat; uygulama bir sonraki restart'ında eski haline döner. Docker, Kubernetes ve elle başlatılmış süreçler listelenir ama Collector onlara dokunmaz; satırdaki Servis ekle adımları gösterir. Başka araçla izleniyor yazan uygulamada zaten bir izleme aracı vardır, Collector üstüne yazmaz.

Tüm uygulamalar tek servis adıyla

Örnek: bir IIS sunucusunda abc, abc-payment ve abc-order siteleri var ve bunları APM'de tek servis, abc olarak görmek istiyorsunuz. Collector tüm uygulamaları tek service.name altında gönderir; her uygulamanın kendi adı spitfire.app resource attribute'unda saklanır.

  1. Uygulama Collector'ları Spitfire'da: /apm/app-collectors sayfasında sunucuya tıklayın.

  2. Tüm uygulamaları tek servis adıyla gönder kartına adı yazın, örneğin:

    text
    abc
  3. Uygulaya basın. Kartta Tüm uygulamalar abc olarak gönderiyor yazar.

  4. Yeni ad uygulama yeniden başlayınca geçerli olur. Kurulumda yeniden başlatma onayı verildiyse Collector uygulamaları kendisi yeniden başlatır; verilmediyse satırdaki komutla siz başlatırsınız.

  5. Kontrol: Bulunan uygulamalar tablosunda her uygulamada → service.name abc ve spitfire.app <kendi adı> görünür. Yeniden başlatmadan sonra APM → Servisler → Servisler Spitfire'da: /apm/services sayfasında abc listelenir.

Bilmeniz gerekenler:

  • Bir uygulamaya kendi penceresinde (Değiştir) yazılan ad bunu geçer.
  • Önceden gelen veri eski adlarla kalır; Spitfire onu yeniden adlandırmaz.
  • Ayar yalnız bu Collector'ı etkiler. Geri dönmek için alanı boşaltıp Uygulaya basın.
  • APM'de uygulamaları ayırmak için servis sayfasındaki Uygulamalar (spitfire.app) kartını, En çok isteklerdeki spitfire.app listesini ya da trace aramada spitfire.app:abc-payment filtresini kullanın.

Adlandırma kuralları

Yalnız bazı uygulamalar birlikte görünecekse kural kullanın. Örnek: üç abc sitesi abc, shop-cart-v2 ise shop-cart olsun, intranet kendi adıyla kalsın.

  1. Uygulama Collector'ları Spitfire'da: /apm/app-collectors sayfasında sunucuya tıklayın.

  2. Tüm uygulamaları tek servis adıyla gönder kartında Adlandırma kuralları (0) düğmesine basın.

  3. Kural ekleye basıp satırı doldurun (glob: * herhangi bir karakter dizisi, adın tamamına büyük/küçük harf ayırmadan uyar):

    • Kalıp:

      text
      abc*
    • service.name:

      text
      abc
  4. Yeniden Kural ekleye basın, regex'i işaretleyin ve ikinci satırı doldurun (Go RE2; $1 ilk gruptur):

    • Kalıp:

      text
      ^shop-(\w+)-v\d+$
    • service.name:

      text
      shop-$1
  5. Önizleme tablosuna bakın: abc, abc-payment ve abc-order Kural 1 ile abc, shop-cart-v2 Kural 2 ile shop-cart, intranet Kendi adı gösterir. Hatalı kural kırmızıyla işaretlenir ve Uygula kapalı kalır.

  6. Uygulaya basın. Kartta 2 adlandırma kuralı yazar.

  7. Kontrol: Bulunan uygulamalar tablosunda abc-payment için → service.name abc, shop-cart-v2 için → service.name shop-cart görünür.

Kurallar yukarıdan aşağı denenir, ilk uyan kazanır: dar kuralları üste koyun. Hiçbir kurala uymayan uygulama, karttaki tek servis adını ya da kendi adını kullanır. Gruptan sonra harf geliyorsa $1x yerine ${1}x yazın. Sonucu geçerli bir service.name olmayan (harf, rakam, . _ / -, en çok 100 karakter) kural atlanır. Collector başına en çok 50 kural.

Kapsam: hariç tutma, modüller, onay listesi

Her Collector için hangi uygulamaların hiç izlenmeyeceğini, hangi modüllerin çalışacağını ve otomatik trace'ten önce listenin size onaylatılıp onaylatılmayacağını seçebilirsiniz. Kurulumda (Gelişmiş ayarlar, komut, collector.json) ya da sonradan Collector sayfasında verilir. Değişiklikler Denetim kaydına Spitfire'da: /audit yazılır.

Hariç tutma

Kalıba uyan uygulamada trace hiç açılmaz; açıksa bir sonraki yeniden başlatmada kalkar.

  1. Uygulama Collector'ları Spitfire'da: /apm/app-collectors sayfasında sunucuya tıklayın.

  2. Kapsam: hariç tutulanlar ve modüller kartında Kalıp ekleye basın.

  3. Kalıbı yazın (glob: * herhangi bir dizi, ? tek karakter; büyük/küçük harf ayırmaz):

    text
    *test*
  4. Önizlemede hariç kalacak uygulamalar hariç (kural 1) ile görünür.

  5. Kaydete basın. Kartın başlığında 1 hariç tutma kalıbı yazar.

  6. Kontrol: Bulunan uygulamalar tablosunda orders-test gibi satırlar soluk görünür ve yanlarında hariç (kural 1) yazar.

Kalıp uygulamanın kendi adına, Spitfire'daki adına ve hizmet adına uygulanır; biri uyarsa yeter. regex işaretliyse kalıp Go RE2'dir (adın tamamı için ^...$). Collector başına en çok 50 kalıp.

Modüller

Aynı kartta Modüller altında işaretini kaldırdığınız modül çalışmaz:

  • Sunucu ölçümleri ve Süreçler ikisi de kapalıysa sunucu Sunucular'da güncellenmez. Süreçler kapalıyken PID, kullanıcı ve komut satırı gönderilmez; trace yine açılabilir.
  • APM kapalıyken hiçbir uygulamada trace açılmaz, açık olanlar geri alınır. IIS kapalıyken de IIS uygulama havuzlarındaki trace'ler geri alınır.
  • Docker kapalıyken container'lar listelenmez.

Modülü yeniden açmak uygulamaları kendiliğinden açmaz; Aç ya da Tümünü izle ile açın.

Onay listesi

Önce listeyi göstereyim, ben onaylayayım işaretliyse otomatik trace hiçbir uygulamayı siz onaylamadan açmaz; sonradan bulunan uygulamalar da onay bekler. Varsayılan kapalıdır. Biz ilk kurulumda, özellikle kalabalık sunucularda bunu açmanızı öneriyoruz.

  1. Kurulumda Gelişmiş ayarlarda kutuyu işaretleyin (komuta --review eklenir) ya da sonradan Collector sayfasındaki kartta işaretleyip Kaydete basın.

  2. Collector rapor verince panelde Onay bekleyen liste görünür.

  3. İzlemek istemediklerinizin işaretini kaldırın. Gerekirse service.name'i düzeltin; birkaç satıra aynı adı yazarsanız tek servis olur. Örnek: orders ve cart satırlarına şunu yazın:

    text
    shop
  4. Onaylaya basın. İşaretli uygulamalarda trace açılır, işareti kaldırılanlar kalıcı olarak hariç kalır.

  5. Kontrol: Bulunan uygulamalar tablosunda orders için → service.name shop ve spitfire.app orders görünür.

Yazdığınız adlar adlandırma kuralı olarak saklanır.

Sessiz kurulumda kapsam

Yazılım dağıtımı için kapsam ayarları parametre olarak verilir; bağlantı koduyla birlikte verilen parametre koddaki değerin yerine geçer.

Ayar Linux / macOS komutu PowerShell msi exe
Hariç tutma --exclude -Exclude EXCLUDE= /EXCLUDE=
Servis adları --names -Names NAMES= /NAMES=
Adlandırma kuralları --rules -Rules RULES= /RULES=
Çalışacak modüller --modules -Modules MODULES= /MODULES=
Onay listesi --review -Review 'true' REVIEW=true /REVIEW=true
  • Değerler virgülle ayrılır. Regex kalıbının başına re: yazın (re:^tmp-). Virgül içeren regex parametreyle verilemez; Collector sayfasından ya da collector.json ile verin.
  • --names uygulama=service.name, --rules kalıp=service.name (abc*=abc) çiftleri alır.
  • --modules çalışacak modüllerin listesidir: host,processes,apm,docker,iis ya da all. none bir listeyi boşaltır (--exclude none).

Linux ya da macOS:

bash
curl -fsSL https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.sh | \
  sudo bash -s -- --from https://spitfire.sirketiniz.com \
    --token sfotlp_... \
    --auto \
    --exclude '*test*' \
    --names 'orders=shop,cart=shop' \
    --modules host,apm,docker,iis \
    --review

Windows PowerShell (Yönetici olarak çalıştır):

powershell
& ([scriptblock]::Create((Invoke-RestMethod -UseBasicParsing 'https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.ps1'))) `
    -From 'https://spitfire.sirketiniz.com' `
    -Token 'sfotlp_...' `
    -Auto `
    -Exclude '*test*' `
    -Names 'orders=shop,cart=shop' `
    -Modules 'host,apm,docker,iis' `
    -Review 'true'

msi ile sessiz kurulum:

powershell
msiexec /i spitfire-apm-collector.msi /qn CODE=SFAPM1.... EXCLUDE="*test*" NAMES="orders=shop,cart=shop" MODULES="host,apm,docker,iis" REVIEW=true

exe ile sessiz kurulum (exe'nin bulunduğu klasörde):

powershell
.\spitfire-apm-collector-setup.exe /S /CODE=SFAPM1.... /EXCLUDE=*test* /NAMES=orders=shop,cart=shop /MODULES=host,apm,docker,iis /REVIEW=true

collector.json içinde (değiştirdikten sonra hizmeti yeniden başlatın):

json
{
  "exclude": [{ "pattern": "*test*" }, { "pattern": "^tmp-(a|b)$", "regex": true }],
  "names": { "orders": "shop", "cart": "shop" },
  "rules": [{ "pattern": "abc*", "service": "abc" }],
  "modules": { "processes": false },
  "review": true
}

Spitfire bu dosyadaki ayarları yalnız değiştiklerinde uygular; Collector sayfasında sonradan yaptığınız değişiklik dosya yeniden değişene kadar geçerli kalır. Kontrol: Collector sayfasındaki kartta collector.json'dan etiketi görünür.

Collector'ı yönetme

Uygulama Collector'ları Spitfire'da: /apm/app-collectors sayfasında bir sunucuyu açın. Collector kartı son rapordaki durumu (Çalışıyor, Durduruldu, Rapor yok), Collector'ın kendi CPU ve bellek kullanımını, log seviyesini ve log'daki son hatayı gösterir. Değişiklikler Collector'a bir sonraki raporunda ulaşır (bekleyen değişiklik varken Collector 15 saniyede bir rapor eder). Değişiklikleri çalışma alanı yöneticisi yapar; her biri Audit log Spitfire'da: /audit'a yazılır.

  • Canlı log: Başlat'a basın; log en geç bir dakikada akmaya başlar. Satırlar yalnız bellekte tutulur (son 1000 satır), diske yazılmaz; .log olarak indirilebilir.
  • Log seviyesi: debug seçip ne zaman info'ya döneceğini belirleyin (15 dakika, 1 saat, 4 saat, 24 saat ya da dönmesin), Uygula'ya basın. Collector o saatte Spitfire'a ulaşamasa da info'ya döner.
  • Durdur: Collector rapor etmeye devam eder ama trace açıp kapatmaz; açtığı uygulamaların trace, metrik ve log'ları Spitfire'da tutulmaz. Uygulamalar yeniden başlatılmaz. Başlat ile geri alınır.

Eski bir Collector'ın kartında güncelleyin uyarısı çıkar. Kurulum komutunu o sunucuda yeniden çalıştırın; ayarlar korunur.

Kaldırma

Linux ve macOS:

bash
curl -fsSL https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.sh | sudo bash -s -- --uninstall

Windows (yönetici PowerShell):

powershell
& ([scriptblock]::Create((Invoke-RestMethod -UseBasicParsing 'https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.ps1'))) -Uninstall

Komut önce uygulamalara eklenen her ayarı geri alır, sonra hizmeti, sunucu ölçümleri parçasını, ayarları, kitleri ve log'u siler; eski Sunucu Collector'ından kalanları da kaldırır. Uygulamaların hemen eski haline dönmesi için sonuna --restart-apps (Windows: -RestartApps) ekleyin. Geri alma bir yerde başarısız olursa kitler ve log silinmez; uygulama bozulmaz, log nedenini gösterir.

Kurulum dosyasıyla kurduysanız: Windows'ta Uygulamalar ve özelliklerden kaldırın, sessiz kaldırma için exe'de & "$env:ProgramFiles\Spitfire\APM\setup\uninstall-apm-collector.exe" /S, msi'de kurulumdaki .msi dosyasıyla msiexec /x spitfire-apm-collector.msi /qn. macOS'ta dmg'deki uygulamayı açıp Kaldır'a basın.

Kontrol (Linux, OK yazmalı):

bash
test ! -e /opt/spitfire-apm && test ! -e /etc/spitfire-apm && test ! -e /usr/local/bin/spitfire-collector && ! systemctl cat spitfire-apm-collector >/dev/null 2>&1 && echo "OK: Spitfire Collector kaldırıldı"

Windows:

powershell
if (-not (Get-Service SpitfireAPMCollector, spitfire-collector -ErrorAction SilentlyContinue)) { 'OK: Spitfire Collector kaldırıldı' }

Sunucuyu listeden silmek için sunucunun sayfasında Listeden kaldıra basın. Diğer bileşenler için: Kurduklarınızı kaldırma.

Sık karşılaşılan sorunlar

Belirti Ne yapın
NOT CONNECTED Spitfire adresini, anahtarı ve sunucudan Spitfire'a çıkışı (proxy, güvenlik duvarı) kontrol edin; sonra check komutunu yeniden çalıştırın.
Sunucu listede Rapor yok Linux: sudo systemctl status spitfire-apm-collector --no-pager; log /var/log/spitfire-apm-collector.log. Windows: Get-Service SpitfireAPMCollector.
Uygulama listede yok Sunucuda sudo /usr/local/bin/spitfire-apm-collector discover ne bulduğunu yazar.
Durum Hata Satırdaki hata metni nedeni söyler (ör. kit indirilemedi). Proxy gerekiyorsa kurulum penceresinde Gelişmiş ayarlara yazıp komutu tekrar çalıştırın; ayarlar güncellenir.
Kurulumdan sonra Restart bekliyor Yeniden başlatma onayı olmadan otomatik trace: uygulama trace'i bir sonraki yeniden başlatmada alır. Satırdaki komutu çalıştırın ya da Şimdi yeniden başlata basın.
Server metrics: not installed here Kurulum komutunu (aynı ayarlarla) yeniden çalıştırın; parça eklenir, ayarlar korunur. İnternetsiz sunucuda --host-binary ile verin.
Sunucu Sunucular'da yok ya da güncellenmiyor Tower kullanmıyorsanız Tower'lar ve metrikler Spitfire'da: /towers → Metrikleri topla ve sakla açık olmalı. Lisansın sunucu sınırı dolduysa Sunucular sayfası bunu söyler. check cannot start diyorsa nedeni Collector log'undadır.
Trace açık ama veri yok APM verisinin bu kurulumda açık olduğunu kontrol edin (Başlamadan önce). Sunucuda Durduruldu yazıyorsa sayfasında Başlat'a basın.