Skip to content

DEBUG.md

Latest commit

 

History

History
134 lines (97 loc) · 5.34 KB

DEBUG.md

File metadata and controls

134 lines (97 loc) · 5.34 KB
Raw

Debugging pentru integrarea CNAIR eRovinieta

Acest ghid oferă pașii necesari pentru a activa logarea detaliată și pentru a analiza problemele din integrare.

1. Activează logarea detaliată

Adaugă în configuration.yaml:

Pentru a activa logarea detaliată pentru integrare, editează fișierul configuration.yaml și adaugă următoarele:

logger:
  default: warning
  logs:
    custom_components.erovinieta: debug
    homeassistant.const: critical
    homeassistant.loader: critical
    homeassistant.helpers.frame: critical

Restartează sistemul

După ce ai salvat fișierul, repornește sistemul Home Assistant pentru ca modificările să fie aplicate.

2. Analizează logurile

Localizarea logurilor

Logurile se află, de obicei, în fișierul home-assistant.log, în directorul principal al Home Assistant.

Filtrarea logurilor

Pentru a găsi rapid informațiile relevante despre integrare, poți folosi comanda:

grep 'custom_components.erovinieta' home-assistant.log

Ce să cauți în loguri:

  • INFO — Mesaje informative: autentificare reușită, date actualizate cu succes, senzori adăugați.
  • WARNING — Avertismente: vehicule cu date incomplete, tranzacții sau vehicule negăsite.
  • ERROR — Erori: autentificare eșuată, erori API, erori la crearea senzorilor.
  • DEBUG — Detalii granulare: răspunsuri brute de la API, cereri HTTP, valori intermediare.

Exemple de mesaje relevante:

INFO     custom_components.erovinieta: Configurăm integrarea CNAIR eRovinieta pentru utilizatorul example@email.com
INFO     custom_components.erovinieta.coordinator: Datele au fost actualizate cu succes.
ERROR    custom_components.erovinieta.api: Cerere de autentificare eșuată: ConnectionError
WARNING  custom_components.erovinieta.coordinator: Date incomplete pentru vehicul: VIN=N/A, PlateNo=N/A

3. Situații normale (nu sunt erori)

Licență — heartbeat

[LICENSE] Heartbeat OK. Licența este validă (expiră: 2027-01-15).

Cauza: verificarea periodică a licenței cu serverul a reușit. Comportament normal.

4. Probleme frecvente

Autentificarea eșuează

  • Verifică dacă username-ul și parola sunt corecte.
  • Verifică dacă site-ul erovinieta.ro este accesibil.
  • Verifică logurile pentru mesajul exact de eroare.

Senzorii nu apar

  • Verifică dacă autentificarea a reușit (caută Autentificarea a reușit în loguri).
  • Verifică dacă datele de la coordinator sunt disponibile (caută erori la get_paginated_data sau get_user_data).
  • Asigură-te că ai cel puțin un vehicul înregistrat în contul eRovinieta.

Starea senzorului „Rovinietă activă" este „Nu" deși ar trebui să fie „Da"

  • Verifică atributul Data sfârșit vignietă al senzorului — data ar putea fi în trecut.
  • Forțează o actualizare manuală a integrării din Setări > Dispozitive și Servicii.

Restanțele treceri pod arată „Nu" deși am trecut podul

  • Senzorul verifică doar trecerile neplătite din ultimele 24 de ore.
  • Datele depind de frecvența de actualizare configurată (implicit: 1 oră).

Licență invalidă

[LICENSE] Licența nu este validă. Motiv: expired / invalid_key / server_unreachable.
[eRovinieta] Licență invalidă — se creează doar LicentaNecesaraSensor.

Cauza: licența a expirat, cheia este greșită, sau serverul de licențe nu este accesibil.

Rezolvare:

  1. Verifică cheia de licență în OptionsFlow
  2. Dacă a expirat, reînnoiește de la hubinteligent.org/donate?ref=erovinieta
  3. Dacă serverul nu e accesibil, există un grace period — licența rămâne validă temporar

Notă

Asigură-te că toate configurațiile din configuration.yaml sunt corecte înainte de a începe procesul de debugging.

Cum să postezi cod în discuții

Pentru a posta cod în mod corect și lizibil, utilizează blocuri de cod delimitate de trei backticks (```) urmate de limbajul codului. De exemplu, pentru YAML, folosește:

```yaml
2025-01-20 15:35:12 INFO     custom_components.erovinieta: Configurăm integrarea CNAIR eRovinieta pentru utilizatorul test_user
2025-01-20 15:35:13 DEBUG    custom_components.erovinieta.coordinator: Începem actualizarea datelor în ErovinietaCoordinator...
2025-01-20 15:35:14 INFO     custom_components.erovinieta.coordinator: Datele au fost actualizate cu succes.
2025-01-20 15:35:15 ERROR    custom_components.erovinieta.api: Cerere de autentificare eșuată: ConnectionError
```

Rezultatul va arăta astfel:

2025-01-20 15:35:12 INFO     custom_components.erovinieta: Configurăm integrarea CNAIR eRovinieta pentru utilizatorul test_user
2025-01-20 15:35:13 DEBUG    custom_components.erovinieta.coordinator: Începem actualizarea datelor în ErovinietaCoordinator...
2025-01-20 15:35:14 INFO     custom_components.erovinieta.coordinator: Datele au fost actualizate cu succes.
2025-01-20 15:35:15 ERROR    custom_components.erovinieta.api: Cerere de autentificare eșuată: ConnectionError

Pași pentru a posta cod:

  1. Scrie ```yaml (trei backticks urmate de "yaml").
  2. Adaugă codul tău pe liniile următoare.
  3. Încheie cu alte trei backticks: ```.

Astfel, codul va fi formatat corespunzător și ușor de citit de ceilalți utilizatori.