# Veri sorunlarını giderme

> Değerler trend grafiklerinde, ortak veri modelinde (UNS) ya da bir veri hedefinde görünmüyorsa olası nedenleri ve her adımda neye bakacağınızı anlatır.

Kaynak: https://proxus.io/tr/docs/troubleshoot/data

Bu sayfa, cihaz okunduğu hâlde değerlerin beklediğiniz yerde görünmediği durumları ele alır. Değerlerin eksik olduğu
yere ait bölümdeki adımları sırayla uygulayın. Önce cihazın gerçekten okunduğundan emin olun: durumu **Bağlı** olmalı ve veri noktalarında
değer görünmelidir (bkz. [Cihazlar](https://proxus.io/tr/docs/troubleshoot/devices)).

## Çalışma durumu denetimlerindeki bulgular

Veri sorunlarının çoğunu [Çalışma durumu denetimleri](https://proxus.io/tr/docs/organize/health-checks) ekranı kendiliğinden bulur.
Veriyle ilgili bulgular şunlardır:

| Bulgu | Anlamı | Ne yapılmalı |
| --- | --- | --- |
| **Edge Gateway çevrim dışı** | Merkez sunucunun Edge Gateway'le bağlantısı yok. Edge Gateway'e bağlı cihazlar, alarm kuralları ve fonksiyonlar veri göndermez. | Bkz. [Edge Gateway'ler](https://proxus.io/tr/docs/troubleshoot/gateways). |
| **Cihaz veri göndermeyi bıraktı** | Cihazdan beklenen aralıkta veri gelmedi. Bulguda `Son veri <süre> önce geldi; beklenen aralık <süre>.` yazar. | Cihazın ağını ve bağlantı ayarlarını kontrol edin. Cihaz kullanımdan kaldırıldıysa devre dışı bırakın. |
| **Cihaz hiç veri göndermedi** | Merkez sunucu başladığından beri cihazdan veri gelmedi. | Cihazın bağlantı ayarlarını ve Edge Gateway'in cihaza ulaşabildiğini kontrol edin. Cihaz henüz sahada kurulmadıysa kurulana kadar devre dışı bırakın. |
| **Kimsenin saklamadığı veya okumadığı veri noktaları** | Veri noktaları okunuyor, ancak değerleri hiçbir yere gitmiyor. | Bu veri noktalarını profilden kaldırın ya da bir veri hedefine veya işlem akışına bağlayın. |
| **Fonksiyon çıktısı hiçbir yere gitmiyor** | Bir fonksiyon değer üretiyor, ancak bu değerleri hiçbir şey kullanmıyor. | |
| **Tüm kaynaklar kapalı** | Bu nesneyi besleyen kaynakların hepsi devre dışı. | Bir kaynağı etkinleştirin ya da nesneyi kaldırın. |

## Değerler trend grafiklerinde ve raporlarda görünmüyor

Trend grafikleri ve raporlar, değerleri Proxus'un geçmiş veri deposundan okur. Değerler bu depoya
**SYSTEM INTERNAL DB** hedefi üzerinden yazılır.

- **Cihaz geçmiş veri deposuna veri göndermiyor.** Yeni cihazlar gönderir, ancak hedef sonradan kaldırılabilir.
  Cihazın **Gönderim** sekmesini açın. **SYSTEM INTERNAL DB** listede yoksa yeniden ekleyin. Hedefin eksik olduğu
  süredeki değerler saklanmamıştır.

- **Bir aktarım işlem akışı değerleri atıyor ya da bekletiyor.** Türü **Aktarım işlem akışı** olan bir işlem akışında
  **At**, **Karantina** ya da **Filtre** düğümü veya **Hata durumunda** ayarı değerlerin kaydedilmesini
  engelleyebilir. İşlem akışının **Adım adım izleme** sekmesine bakın.
- **Değerlerin saklama süresi dolmuş.** `[ClickHouse] ClickHouseTTLExpression` ayarlıysa süresi dolan değerler silinir.
- **Zaman aralığı yanlış.** Aralığı genişletin ve değerlerin aralığın hemen dışında kalmadığından emin olun.
- **Geçmiş veri deposuna ulaşılamıyor.** **SYSTEM INTERNAL DB** hedefinde **Denetle**'yi seçtiğinizde son hata
  görünür. Bu durumda [Telemetry API](https://proxus.io/tr/docs/develop/telemetry-api) `ClickHouse connection failed: ...` yanıtını
  döndürür.

## Değerler veri hedefine ulaşmıyor

1. Hedefi açın ve **Denetle**'yi seçin.
2. Parametre denetiminin sonucunu okuyun. Hata varsa (`'<key>' is required but missing or empty.`) hedef çalışamaz.
   `'<key>' is not set, so the channel falls back to '<value>'.` gibi bir uyarı ise hedefin beklediğinizden başka bir
   yere, örneğin `localhost` adresine ya da `proxus_device_data` konusuna yazdığını gösterir.
3. Çalışma durumunu okuyun: **Durum**, **Son başarılı gönderim**, **Son hata zamanı** ve **Son hata**. `Degraded`,
   hedefin daha önce çalıştığını ve şimdi hata verdiğini gösterir. `Error` ise hedefin hiç çalışmadığı anlamına
   gelir. Hedefe ulaşılamadığı sürece hata metninde, Edge Gateway'de kuyrukta bekleyen mesaj sayısı da yer alır. Bu
   mesajlar, Edge Gateway'in **Ara bellek saklama süresi (saat)** değerinden (varsayılan 48 saat) eski değilse hedefe
   yeniden ulaşıldığında yazılır.
4. **Bağlantıyı test et**'i seçin. Testi merkez sunucudan değil, cihazları okuyan Edge Gateway'den çalıştırın, çünkü
   veri hedeflerine Edge Gateway'ler yazar. Yalnızca tesis ağından erişilebilen bir hedef, merkez sunucudan test
   edildiğinde başarısız görünür.

| Test sonucu | Anlamı |
| --- | --- |
| `Bağlandı: <hedef> ayarlanan kimlik bilgilerini kabul etti.` | Adres ve kimlik bilgileri doğru. Veri yine de gelmiyorsa konu, tablo ya da yol üzerindeki yazma yetkilerini kontrol edin. |
| `Erişilebilir: <hedef> adresine bağlantı kuruldu.` | Karşı tarafta yanıt veren bir sistem var, ancak kimlik bilgileri doğrulanmadı. |
| `Failed: the target did not answer within <n> seconds.` | Adres ya da port yanlış veya bir güvenlik duvarı bağlantıyı engelliyor. |
| Hedefin kendi mesajıyla birlikte `Failed: ...` | Örneğin kimlik bilgileri yanlış ya da bucket veya dosya sistemi yok. |
| `Bu platform sürümünde bu hedef türü için bağlantı testi yok: <tür>.` | Bu hedef türü için bağlantı testi yok. |
| `Çalıştırılmadı: önce yukarıdaki yapılandırma hatalarını düzeltin.` | Önce parametre denetimindeki hataları düzeltin. |

Diğer olası nedenler:

- **Cihaz bu hedefe veri göndermiyor.** Cihaz yalnızca kendisinde seçili hedeflere veri gönderir (sihirbazdaki
  **Veri nereye gidecek?** adımı). Hedefteki **Kullanan cihazlar** alanı, bu hedefe kaç cihazın veri gönderdiğini
  gösterir.
- **Hedefin stratejisi Değiştiğinde olarak ayarlı.** Bu stratejide değişmeyen değerler gönderilmez. **Yalnızca işlem akışları**
  stratejisinde ise cihazlardan hiç veri gönderilmez.
- **Sunucu sertifikası reddediliyor.** Her TLS bağlantısında sunucu doğrulanır. Sunucu kendinden imzalı ya da özel
  bir CA'dan alınmış sertifika kullanıyorsa bu CA'yı [Sertifika deposu](https://proxus.io/tr/docs/administer/certificates)'na ekleyin
  ve hedefte güvenilen sunucu sertifikası olarak seçin. Bkz.
  [TLS parametreleri](https://proxus.io/tr/docs/reference/outbound-targets#tls-parametreleri).
- **Bir kayıt atlanıyor.** Hedefin yanıt verdiği ama hiçbir zaman kabul etmediği bir kayıt (örneğin sütuna sığmayacak
  uzunlukta bir değer) birkaç denemeden sonra atlanır ve durum bilgisinde belirtilir. Sonraki veriler yazılmaya
  devam eder.
- **Hedef türü bu sürümde kullanılamıyor.** Bazı veritabanı türlerine yazılamaz. Bkz.
  [Veri hedefleri](https://proxus.io/tr/docs/reference/outbound-targets#bu-sürümde-kullanılamayan-türler).

## Değerler ortak veri modelinde (UNS) görünmüyor

UNS konularını her Edge Gateway'in kendi MQTT sunucusu yayınlar. Bkz. [MQTT ve UNS konuları](https://proxus.io/tr/docs/develop/mqtt).

- **Yanlış Edge Gateway'in MQTT sunucusuna bağlandınız.** Her Edge Gateway yalnızca kendi cihazlarının verisini yayınlar.
- **İstemci reddediliyor.** İstemci, kullanıcı adı olarak Edge Gateway'in `MasterToken` değerini kullanmalıdır.
- **Konu beklediğinizden farklı.** Cihazın konumundaki boş düzeyler konuya eklenmez, boşluklar da `_` karakterine
  dönüşür. Gerçek konuları görmek için `v1/#` konusuna abone olun.
- **Yayınlama kapalı.** Edge Gateway'de `[MQTTBroker] Enabled` ve `EnableMQTTHooks` ayarlarının ikisi de `true`
  olmalıdır.
- **Edge Gateway başka bir porta geçti.** Edge Gateway, başlarken 1883 portu kullanımdaysa başka bir port seçer ve günlüğe
  `Configured port 1883 is already in use. Using fallback port <port>.` satırını yazar.
- **Geçersiz değerler yayınlanmıyor.** Okunamayan veri noktaları telemetri konularında görünmez.

## Değerler gecikmeli ya da seyrek geliyor

- `_summary` ve `_lastSeen` mesajları, tasarım gereği cihaz başına en fazla 5 saniyede bir gönderilir
  (`SummaryIntervalMs`, `LastSeenIntervalMs`).
- Stratejisi **Değiştiğinde** olan bir hedef yalnızca değişen değerleri gönderir.
- Edge Gateway ya da hedef bir süre çevrim dışı kaldıysa ara bellekte bekleyen değerler kendi zaman damgalarıyla
  toplu olarak gelir.
- Veri hedefine her kayıt en az bir kez yazılır. Onayı yolda kaybolan bir kayıt nadiren iki kez yazılabilir.

## Sonraki adımlar

- [Cihaz sorunlarını giderme](https://proxus.io/tr/docs/troubleshoot/devices): cihaz okunmuyorsa ya da veri noktası hata veriyorsa.
- [Veri hedefleri](https://proxus.io/tr/docs/reference/outbound-targets): hedef türleri, parametreler, TLS ve ara bellek ayarları.
- [Çalışma durumu denetimleri](https://proxus.io/tr/docs/organize/health-checks): sistem genelindeki bulguların tam listesi.