> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# `agenteye-collector`'a Geçiş

> AgentEye `agenteye-collector`'a Geçiş belgelendirmesi.

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](/tr/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](/tr/agenteye/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](/tr/agenteye/collector-installation#option-a-binary-recommended) 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:

```bash theme={null}
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:

```ini theme={null}
[Service]
ExecStart=/usr/local/bin/agenteye-collector start
```

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

```bash theme={null}
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:

```bash theme={null}
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:

```ini theme={null}
[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:

```yaml theme={null}
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](#upgrades-from-now-on)).

***

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

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

```bash theme={null}
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](/tr/agenteye/collector-installation#option-a-binary-recommended) 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

```bash theme={null}
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.         |