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
- 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. - 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.
- 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.
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 vesfcol_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.
- Sunucuda
sudoyetkisi olan bir kullanıcıyla terminal açın. - Kurulum penceresindeki komutu yapıştırıp Enter'a basın. Komut şu biçimdedir:
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- Komut gereksinimleri kontrol eder, Collector'ı kurar, bağlantıyı dener ve hizmeti başlatır.
- Başarı kontrolü: aşağıdaki komut
OK: connected to ...satırını ve altındaServer metrics: on, as "SUNUCU-ADI", to Spitfire (Servers).satırını yazmalı (Tower ile:to the Tower ... (Servers)).
sudo /usr/local/bin/spitfire-apm-collector check- Hizmetin durumu (
active (running)yazmalı):
sudo systemctl status spitfire-apm-collector --no-pager- Yaklaşık 1 dakika içinde sunucu Sunucular
Spitfire'da: /serverssayfası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
- Kurulum penceresinde Kurulum dosyası (msi/exe) sekmesini seçin.
spitfire-apm-collector-setup.exe(ya daspitfire-apm-collector.msi) dosyasını indirin, gerekirse sunucuya kopyalayın.- Bağlantı kodunun yanındaki kopyala düğmesine basın (kod
SFAPM1.ile başlar). - 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.
- Başarı kontrolü için PowerShell'i Yönetici olarak çalıştır ile açın:
& "$env:ProgramFiles\Spitfire\APM\spitfire-apm-collector.exe" check -config "$env:ProgramData\Spitfire\APM\collector.json"; Get-Service SpitfireAPMCollectorOK: 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....):
msiexec /i spitfire-apm-collector.msi /qn CODE=SFAPM1....Komutla
- PowerShell'i Yönetici olarak çalıştır ile açın.
- Kurulum penceresindeki komutu yapıştırıp Enter'a basın. Komut şu biçimdedir:
& ([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- Başarı kontrolü yukarıdaki
checkkomutudur.
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
- Kurulum penceresinde Kurulum dosyası (dmg) sekmesini seçin ve
spitfire-apm-collector.dmgdosyasını indirin. - Bağlantı kodunun yanındaki kopyala düğmesine basın.
- 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.
- Başarı kontrolü (Terminal):
OK: connected to ...veServer metrics: on, as "SUNUCU-ADI", to Spitfire (Servers).satırlarını görmelisiniz.
sudo /usr/local/bin/spitfire-apm-collector check- Yaklaşık 1 dakika içinde sunucu Sunucular
Spitfire'da: /serverssayfası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ı:
sudo launchctl print system/tr.spitfire.apm-collector | grep stateDosyalar: 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 metriklerSpitfire'da: /towerssayfası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:-Towerve-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):
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 checkWindows (yönetici PowerShell):
if (Get-Service spitfire-collector -ErrorAction SilentlyContinue) { 'Eski hizmet hâlâ var' } else { "OK: eski Sunucu Collector'ı kaldırıldı" }; Get-Service SpitfireAPMCollectorEski 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:
- Uygulama Collector'ları
Spitfire'da: /apm/app-collectorssayfasında sunucuya tıklayın. - Bulunan uygulamalar tablosunda uygulamanın satırındaki Trace'i aça basın.
- service.name önerilen adla gelir; gerekirse değiştirin. Ortam ve örnekleme boşsa kurulumdaki değerler geçer.
- 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.
- Trace'i aça basın. İstek en geç bir dakika içinde Collector'a ulaşır.
- Kontrol: uygulama yeniden başlayınca durum Trace açık olur ve trace'ler APM → Servisler → Servisler
Spitfire'da: /apm/servicessayfası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.
Uygulama Collector'ları
Spitfire'da: /apm/app-collectorssayfasında sunucuya tıklayın.Tüm uygulamaları tek servis adıyla gönder kartına adı yazın, örneğin:
abcUygulaya basın. Kartta Tüm uygulamalar abc olarak gönderiyor yazar.
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.
Kontrol: Bulunan uygulamalar tablosunda her uygulamada
→ service.name abcvespitfire.app <kendi adı>görünür. Yeniden başlatmadan sonra APM → Servisler → ServislerSpitfire'da: /apm/servicessayfasındaabclistelenir.
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-paymentfiltresini 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.
Uygulama Collector'ları
Spitfire'da: /apm/app-collectorssayfasında sunucuya tıklayın.Tüm uygulamaları tek servis adıyla gönder kartında Adlandırma kuralları (0) düğmesine basın.
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:
abc*service.name:
abc
Yeniden Kural ekleye basın, regex'i işaretleyin ve ikinci satırı doldurun (Go RE2;
$1ilk gruptur):Kalıp:
^shop-(\w+)-v\d+$service.name:
shop-$1
Önizleme tablosuna bakın:
abc,abc-paymentveabc-orderKural 1 ileabc,shop-cart-v2Kural 2 ileshop-cart,intranetKendi adı gösterir. Hatalı kural kırmızıyla işaretlenir ve Uygula kapalı kalır.Uygulaya basın. Kartta 2 adlandırma kuralı yazar.
Kontrol: Bulunan uygulamalar tablosunda
abc-paymentiçin→ service.name abc,shop-cart-v2için→ service.name shop-cartgö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.
Uygulama Collector'ları
Spitfire'da: /apm/app-collectorssayfasında sunucuya tıklayın.Kapsam: hariç tutulanlar ve modüller kartında Kalıp ekleye basın.
Kalıbı yazın (glob:
*herhangi bir dizi,?tek karakter; büyük/küçük harf ayırmaz):*test*Önizlemede hariç kalacak uygulamalar
hariç (kural 1)ile görünür.Kaydete basın. Kartın başlığında 1 hariç tutma kalıbı yazar.
Kontrol: Bulunan uygulamalar tablosunda
orders-testgibi satırlar soluk görünür ve yanlarındahariç (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.
Kurulumda Gelişmiş ayarlarda kutuyu işaretleyin (komuta
--revieweklenir) ya da sonradan Collector sayfasındaki kartta işaretleyip Kaydete basın.Collector rapor verince panelde Onay bekleyen liste görünür.
İzlemek istemediklerinizin işaretini kaldırın. Gerekirse service.name'i düzeltin; birkaç satıra aynı adı yazarsanız tek servis olur. Örnek:
ordersvecartsatırlarına şunu yazın:shopOnaylaya basın. İşaretli uygulamalarda trace açılır, işareti kaldırılanlar kalıcı olarak hariç kalır.
Kontrol: Bulunan uygulamalar tablosunda
ordersiçin→ service.name shopvespitfire.app ordersgö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 dacollector.jsonile verin. --namesuygulama=service.name,--ruleskalıp=service.name(abc*=abc) çiftleri alır.--modulesçalışacak modüllerin listesidir:host,processes,apm,docker,iisya daall.nonebir listeyi boşaltır (--exclude none).
Linux ya da macOS:
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 \
--reviewWindows PowerShell (Yönetici olarak çalıştır):
& ([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:
msiexec /i spitfire-apm-collector.msi /qn CODE=SFAPM1.... EXCLUDE="*test*" NAMES="orders=shop,cart=shop" MODULES="host,apm,docker,iis" REVIEW=trueexe ile sessiz kurulum (exe'nin bulunduğu klasörde):
.\spitfire-apm-collector-setup.exe /S /CODE=SFAPM1.... /EXCLUDE=*test* /NAMES=orders=shop,cart=shop /MODULES=host,apm,docker,iis /REVIEW=truecollector.json içinde (değiştirdikten sonra hizmeti yeniden başlatın):
{
"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;
.logolarak indirilebilir. - Log seviyesi:
debugseçip ne zamaninfo'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 dainfo'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:
curl -fsSL https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.sh | sudo bash -s -- --uninstallWindows (yönetici PowerShell):
& ([scriptblock]::Create((Invoke-RestMethod -UseBasicParsing 'https://spitfire.sirketiniz.com/api/v1/runner-dist/install-apm-collector.ps1'))) -UninstallKomut ö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ı):
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:
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. |