`agenteye-collector`'a Geçiş

Geçiş yıkıcı değildir: hiçbir kapalı kalma süresi ve veri kaybı olmaz ve kısa agenteye adını AgentEye CLI için serbest bırakır, böylece collector daemon ve CLI aynı makinede birlikte yaşayabilir. Collector ikili dosyası agenteye’den agenteye-collector’a yeniden adlandırıldı. Kısa agenteye adı artık AgentEye CLI’ye aittir; bu, terminalinizden oturumları, olayları ve değerlendirmeleri sorgulamak için ayrı bir araçtır. Bu kılavuz, mevcut bir collector kurulumunu geçirmede size yol gösterir.

Değişen Neler

	Öncesi	Sonrası
Komut / ikili dosya	`agenteye`	`agenteye-collector`
Varsayılan kurulum yolu	`/usr/local/bin/agenteye`	`/usr/local/bin/agenteye-collector`
Alt komutlar	`start`, `flush`, `health`, `update`	`start`, `flush`, `health`
Kendi kendini güncelleme (`agenteye update`)	yerleşik	kaldırıldı: yeni ikili dosyayı indirin veya yeni görüntüyü çekin
Kurulum komut dosyası (`install.sh`)	sağlandı	kaldırıldı: ikili dosyayı doğrudan indirin (bkz. Collector Installation)
`AGENTEYE_TOKEN`	ikili dosyaları indirmek ve arka plan güncelleme denetimleri için gerekli	yalnızca ikili dosyaları/görüntüleri indirmek için gerekli

Yapılandırma değişmedi: aynı ~/.agenteye/config.json, aynı AGENTEYE_URL / AGENTEYE_KEY / AGENTEYE_HOME / TLS ortam değişkenleri ve aynı ~/.agenteye/events/ spool. Hiçbir yapılandırma düzenlemesi gerekmez.

Yeniden adlandırılan ikili dosyayı eski agenteye adı altında çalıştırırsanız, yine de çalışır ancak stderr’ye bir satırlık bir kullanımdan kaldırma uyarısı yazdırır ve agenteye-collector’a geçmenizi hatırlatır.

Başlamadan Önce

Mevcut agenteye kurulumunuz çalışmaya devam eder; yükseltme anında hiçbir şey bozulmaz. Kasıtlı olarak geçiş yapın, sonra eski ikili dosyayı en son silin.
Kapalı kalma süresini önlemek için şu sırayı izleyin:
1. Yeni agenteye-collector ikili dosyasını kurun (veya yeni görüntüyü çekin).
2. Hizmet tanımınızı / sağlık sondanızı / komut dosyalarınızı agenteye-collector’ı çağıracak şekilde güncelleyin.
3. Hizmeti yeniden yükleyin ve yeniden başlatın; sağlıklı olduğunu doğrulayın.
4. Yalnızca o zaman eski /usr/local/bin/agenteye ikili dosyasını silin.

1. Yeni İkili Dosyayı Kurun

Platformunuz için yapıyı (agenteye-collector-linux-x86_64, agenteye-collector-darwin-arm64, vb.; tam liste için Collector Installation → Option A bölümüne bakın) en son collector/v<version> sürümünden indirin ve /usr/local/bin/agenteye-collector konumuna yerleştirin. Docker kullanıcıları: docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (veya sabitlenmiş bir :v<version> etiketi tercih edilir; :latest yalnızca kararlı sürümler için mevcuttur). Doğrulayın:

agenteye-collector --version

2. Dağıtımınızı Güncelleyin

systemd (Linux)

/etc/systemd/system/agenteye-collector.service dosyasını düzenleyin, böylece ExecStart yeni ikili dosyaya işaret eder:

[Service]
ExecStart=/usr/local/bin/agenteye-collector start

Ardından yeniden yükleyin ve yeniden başlatın:

sudo systemctl daemon-reload
sudo systemctl restart agenteye-collector
sudo systemctl status agenteye-collector

launchd (macOS)

Marka yeniden adlandırması: Mevcut plist dosyanız daha eski yolda ~/Library/LaunchAgents/host.exosphere.agenteye-collector.plist ise, dosyayı ai.befailproof.agenteye-collector.plist olarak yeniden adlandırın ve ayrıca dosyanın içindeki <key>Label</key> değerini yeni tanımlayıcıya değiştirin, sonra yeniden yükleyin.

~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist dosyasında, ilk ProgramArguments girdisini /usr/local/bin/agenteye yerine /usr/local/bin/agenteye-collector olarak değiştirin, sonra yeniden yükleyin:

launchctl unload ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist
launchctl load   ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist

supervisord

supervisord program bloğunuzda, command’i yeni ikili dosyaya ayarlayın:

[program:agenteye-collector]
command=/usr/local/bin/agenteye-collector start

Ardından supervisorctl reread && supervisorctl update komutunu çalıştırın.

Docker / Kubernetes

Yeni görüntüyü çekin (ghcr.io/agenteye-enterprise/collector:beta-latest veya sabitlenmiş bir :v<version> etiketi tercih edilir; :latest yalnızca kararlı sürümler için mevcuttur). Görüntü entrypoint zaten agenteye-collector olduğundan, start alt komutuyla aynı docker run komutu değişiklik olmadan çalışmaya devam eder. Önemli: sağlık sondalarını güncelleyin. Kubernetes canlılık/hazırlık sondası veya ikili dosyayı ada göre çalıştıran herhangi bir docker exec kullanıyorsanız, komutu agenteye-collector olarak değiştirin:

livenessProbe:
  exec:
    command: ["agenteye-collector", "health"]

Yeni görüntü agenteye alias’ını göndermiyor, bu nedenle hala agenteye çağıran bir sonda başarısız olur. Sondayı yeni görüntüyle aynı dağıtımda güncelleyin.

Cron / manuel komut dosyaları

Herhangi bir agenteye start|flush|health çağırmasını eşleşen agenteye-collector start|flush|health komutuyla değiştirin. Herhangi bir agenteye update cron işini silin; bu alt komut artık mevcut değildir (bkz. Bundan sonraki yükseltmeler).

3. Eski İkili Dosyayı Silin (En Son)

Hizmet agenteye-collector üzerinde çalıştığında ve sağlıklı olduğunu bildirdiğinde:

sudo rm /usr/local/bin/agenteye

Bu, özellikle AgentEye CLI da kullanıyorsanız önemlidir; bu da kendi agenteye komutunu kurar; eski collector ikili dosyasını /usr/local/bin/agenteye konumunda bırakmak, agenteye adını PATH üzerinde belirsiz hale getirir.

Bundan Sonraki Yükseltmeler

Collector artık kendi kendini güncellemiyor. Yükseltmek için:

İkili dosya: platformunuz için yeni yapıyı indirin (örneğin agenteye-collector-linux-x86_64; tam liste için Collector Installation → Option A bölümüne bakın), /usr/local/bin/agenteye-collector dosyasını değiştirin ve hizmeti yeniden başlatın.
Docker: docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (veya sabitlenmiş bir :v<version> etiketi tercih edilir; :latest yalnızca kararlı sürümler için mevcuttur) ve konteyneri yeniden oluşturun.

AGENTEYE_TOKEN hala özel sürümler deposundan indirmek için gereklidir, ancak çalışan daemon artık buna ihtiyaç duymamaktadır.

Doğrulayın

agenteye-collector --version    # yeni ikili dosya PATH'te
agenteye-collector health       # çıkış 0 = sağlıklı
agenteye-collector flush        # sıraya alınan olayları iletir ve temiz çıkar

Ardından yeni olayların panonuzda göründüğünü doğrulayın.

Geri Al

Geçiş yıkıcı değildir. Geri almanız gerekiyorsa, hizmet tanımınızı eski /usr/local/bin/agenteye ikili dosyasına geri işaret edin (henüz kaldırmadığınız sürece) ve yeniden başlatın. Olay spool ve yapılandırma paylaşılır ve etkilenmez.

Sorun Giderme

Belirti	Neden	Çözüm
`warning: the collector binary is now agenteye-collector …` her çalıştırmada	İkili dosyayı eski `agenteye` adı altında çağırıyorsunuz	Bunun yerine `agenteye-collector` komutunu çağırın; hizmet dosyalarını ve komut dosyalarını güncelleyin.
systemd başarısız olur: `.../agenteye: No such file or directory`	Eski ikili dosyayı `ExecStart` güncellemeden önce kaldırdınız	`ExecStart=/usr/local/bin/agenteye-collector start` komutunu ayarlayın, ardından `sudo systemctl daemon-reload` komutunu çalıştırın.
Kubernetes pod’u görüntü yükseltmesinden sonra crash-loops yapıyor	Canlılık sondası hala `agenteye` çalıştırıyor	Sonda komutunu `["agenteye-collector", "health"]` olarak değiştirin.
`agenteye: command not found`, ancak `agenteye-collector` çalışıyor	Komut dosyaları/takma adlar hala eski adı referans alıyor	Bunları `agenteye-collector` olarak güncelleyin.
`agenteye` komutunu çalıştırmak CLI’yi başlatıyor, collector’ı değil	AgentEye CLI yüklü; `agenteye` adına sahip	Daemon için `agenteye-collector` kullanın ve `/usr/local/bin/agenteye` konumunda kalan eski collector ikili dosyasını silin.

​Değişen Neler

​Başlamadan Önce

​1. Yeni İkili Dosyayı Kurun

​2. Dağıtımınızı Güncelleyin

​systemd (Linux)

​launchd (macOS)

​supervisord

​Docker / Kubernetes

​Cron / manuel komut dosyaları

​3. Eski İkili Dosyayı Silin (En Son)

​Bundan Sonraki Yükseltmeler

​Doğrulayın

​Geri Al

​Sorun Giderme