Tato stránka byla strojově přeložena. Přečtěte si anglický originál. English

Tento průvodce je určen lidem, kteří používají konzoli HQ Monitor: DBA, podpůrným inženýrům a administrátorům. Ukazuje každou stránku konzole, vysvětluje, co na ní vidíte, a ukazuje, jak stránky použít k nalezení problému.

HQ Monitor je webová konzole pro servery Firebird. Nepřipojuje se k Firebird. Zobrazuje data, která HQbird agent (fbagent) shromažďuje na každém serveru: CPU a paměť, připojení, transakce, trace, logy, statistiky gstat a reporty.

O obrázcích. Obrázky pocházejí z funkční konzole (HQ Monitor 1.57.0, agenti 3.4.0, editor konfigurace 1.61.0) se zapnutým demo režimem (viz Nastavení). Ukazují 12 pracovních hodin (08:00–20:00) dne před pořízením obrázků. Výjimkou je stránka Servers: nemá výběr dne a vždy zobrazuje nejnovější hodiny (na obrázcích 00:00–02:44 dne pořízení). Názvy serverů, databází a procesů a cesty na obrázcích jsou vymyšlená slova stejné délky jako skutečná, například siserikoditobefikepebur. Demo režim také mění některá slova uživatelského rozhraní, například „Security“ v Security.fdb/Users; tento text používá skutečné názvy. IP adresy začínají na 192.168. Tajné hodnoty jsou skryté. V tomto textu SRV označuje název serveru a employee název databáze.


Obsah

  1. Jak HQ Monitor funguje
  2. Přihlášení a obecné ovládací prvky
  3. Stránka Servers
  4. Přehled serveru
  5. Stránky databáze
  6. Statistiky: reporty gstat a trendy
  7. Nástroje serveru: Logs, Configs, Errors, Conflicts, Perf Report
  8. Report stavu serveru
  9. Editor konfigurace agenta, Backups a Activity
  10. Licence
  11. Administrace: uživatelé, clustery, oznámení a aktualizace
  12. Instalace a nastavení pro administrátory
  13. Řešení problémů

1. Jak HQ Monitor funguje

Odkud data pocházejí

Where the data comes from
  • Agent shromažďuje data na serveru Firebird a zapisuje je do souborů.
  • V collection center posílají agenti své soubory přes goafts. Soubory dorazí do datové složky konzole (data_path), jedna složka na server.
  • Vedle jednoho agenta (lokální instalace) čte konzole složku tohoto agenta přímo. Viz LOCAL_INSTALL.md.
  • Konzole pouze čte soubory. Nikdy se nepřipojuje k Firebird.
  • Změny jdou opačným směrem (přerušované čáry). V collection center jde změna konfigurace, požadavek Run now nebo licence do goafts. Agent je převezme při své další synchronizaci, obvykle do minuty. V lokální instalaci předává konzole tyto změny agentovi vedle sebe přímo.

Stránky jsou v obou typech instalace stejné.

Mapa stránek

Page map
  • Přehled má dvě cesty k reportu stavu serveru:
    • Server status v časové liště otevře report nejnovějšího snímku stavu v časovém rozsahu;
    • Report for this minute (pod vybranou minutou) otevře report snímku, který tuto minutu pokrývá.
  • Každá stránka serveru má stejné menu v záhlaví: Logs, Configs, Errors, Conflicts, Perf Report, Jobs a Backups. Stránky databáze je mají také. Viz Záhlaví a řádek s drobečkovou navigací.
  • Ikona ozubeného kola v záhlaví otevírá Nastavení z každé stránky.
  • Stránky databáze mají pod záhlavím řádek s názvem databáze a stránkami databáze. Jeho položka Performance report otevírá Perf Report serveru pro tuto databázi.

Typické vyšetřování

A typical investigation
  1. Začněte na stránce Servers. Hledejte červený nebo oranžový stav.
  2. Otevřete Report pro tento server. Zjištění vám řeknou, co agent viděl.
  3. Otevřete dashboard. Najděte na grafech čas problému.
  4. Klikněte na tento bod (viz Výběr minuty). Grafy označí tuto minutu a tabulky otevřených řádků databáze zobrazí tuto minutu.
  5. Otevřete řádek databáze. Přečtěte si nejnáročnější dotazy a připojení této minuty.
  6. Přejděte na stránku, která problému odpovídá.

2. Přihlášení a obecné ovládací prvky

Přihlášení

The sign-in page
The sign-in page

Co vidíte

  1. Záhlaví: logo HQbird s verzí konzole pod ním (zde 1.57.0) a seznam jazyků (EN) vpravo.
  2. Přihlašovací pole: Login, Password a tlačítko Sign in.

Přihlášení:

  1. Otevřete adresu konzole v prohlížeči, například http://192.168.0.10:8080. Adresu a port vám sdělí administrátor.
  2. Zadejte Login a Password a klikněte na Sign in.
  3. Konzole otevře stránku Servers.

Jak relace funguje:

  • Přihlašovací jméno rozlišuje velikost písmen.
  • Relace trvá 7 dní. Poté, nebo po restartu konzole, se přihlaste znovu.
  • Prohlížeč uchovává relaci v cookie pojmenované podle portu konzole, například fbmonitor_auth_8080. Dvě konzole na jednom hostiteli (na různých portech) tak mají oddělené relace. Když se přihlásíte do jedné, zůstanete přihlášeni i v druhé.
  • Log out (v pravém horním rohu každé stránky) ukončí všechny relace vašeho přihlášení ve všech prohlížečích. V režimu single uživatele existuje jen jedno přihlášení, takže Log out odhlásí všechny, kdo tuto konzoli používají.
  • Když se změní heslo (na stránce Nastavení nebo na hostiteli agenta), všechny ostatní relace skončí. Tyto prohlížeče se přihlásí znovu.
  • V režimu multiple uživatelů (viz Uživatelé) konzole kontroluje váš účet při každém požadavku. Když administrátor váš účet smaže nebo mu nastaví nové heslo, vaše relace skončí.

Odkud pochází heslo v režimu single uživatele: konzole kontroluje heslo, které místní agent uchovává jako hash ve svém agent_config.json (fbagent 2.80.0 nebo novější). Agent jej zapíše při nastavení a při importu access.properties z FBDataGuard. Bez něj konzole čte access.properties jako dříve.

Pokud se v single režimu přihlásíte slabým heslem, zobrazí se pod záhlavím řádek Your password is weak, change it. Slabé heslo je výchozí heslo FBDataGuard strong password, heslo kratší než 7 znaků nebo heslo bez písmene nebo bez číslice. Řádek odkazuje na Change password na stránce Nastavení. Když konzole nemůže heslo změnit, řádek místo toho uvede příkaz, který je třeba spustit na hostiteli agenta: fbagent --reset-hqmonitor-password.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Invalid login or password Nesprávné přihlašovací jméno nebo heslo.
Too many login attempts. Try again in 15 minutes 8 neúspěšných pokusů z vaší adresy za 15 minut. Počkejte a zkuste to znovu. Úspěšné přihlášení počet vynuluje.
access.properties is missing or cannot be read Režim single uživatele: konzole nenašla žádné heslo, ani v agent_config.json agenta, ani v access.properties. Obraťte se na administrátora.
users.enc is missing or cannot be read Režim multiple uživatelů: soubor uživatelů chybí nebo je poškozený. Obraťte se na administrátora.

Záhlaví a řádek s drobečkovou navigací

Každá stránka po přihlášení má nahoře záhlaví. Na stránce serveru (přehled, stránky databáze, nástroje serveru) obsahuje zleva doprava:

  1. Logo HQbird s verzí konzole. U release buildu najeďte na verzi a uvidíte číslo buildu a čas sestavení, například build 128 · 2026-09-04 03:12 UTC.
  2. ← Servers: vrátí na stránku Servers.
  3. Název serveru. Kliknutím otevřete přehled serveru.
  4. Menu: Logs, Configs, Errors, Conflicts, Perf Report, Jobs a Backups. Stránka, na které jste, je zvýrazněna. Jobs a Backups se zobrazují jen tehdy, když konzole může pro tento server otevřít editor konfigurace.
  5. Vpravo: ikona ozubeného kola (Nastavení), Log out a seznam jazyků.

Řádek databáze. Stránka databáze má pod záhlavím ještě jeden řádek. Začíná štítkem DB a názvem databáze, následují stránky databáze. Menu serveru nad ním zůstává beze změny, takže logy nebo chyby serveru jsou vzdálené jedno kliknutí. Viz Stránky databáze.

Ostatní stránky mají kratší záhlaví:

Stránka Záhlaví
Servers Logo, ikona ozubeného kola, Log out, jazyk. Žádné ← Servers, žádné menu.
Licenses, Updates, Notifications, User management, Clusters Logo, ← Servers, ikona ozubeného kola, Log out, jazyk. Žádný název serveru, žádné menu.
Settings Záhlaví poslední stránky serveru, kterou jste v této kartě prohlížeče otevřeli, bez názvu serveru.
Editor konfigurace (Jobs, Backups, Activity) Plné záhlaví serveru. Viz kapitola 9.

Řádek s drobečkovou navigací. Pod záhlavím tenký řádek ukazuje, kde jste. Vždy začíná položkou Servers. Kliknutím na kterýkoli krok se na něj vrátíte. Poslední krok je stránka, na které jste. Příklady:

  • Servers › SRV: přehled serveru;
  • Servers › SRV › Logs: nástroj serveru;
  • Servers › SRV › employee › Statistics › Report: stránka databáze;
  • Servers › SRV › Jobs › Activity: editor konfigurace;
  • Servers › Licenses, Servers › Users › Add user, Servers › Settings: stránky, které se netýkají jednoho serveru.

Najeďte na krok serveru nebo databáze a uvidíte jeho plný název. Stránka Servers a přihlašovací stránka řádek s drobečkovou navigací nemají.

Řádky pod záhlavím. Pod řádkem s drobečkovou navigací může konzole zobrazit tyto řádky (ne na stránkách editoru konfigurace):

  • červený licenční řádek, když agent zastavil licenční úlohy: „No license. Backups, restore, sweep, tracing, statistics and replication are stopped. The databases work.“;
  • žlutý zkušební řádek, když zkušební období končí za 7 dní nebo dříve: „Trial: 5 days left. To extend it to 30 days, enter a work email.“;
  • řádek slabého hesla (pouze v režimu single uživatele, viz Přihlášení).

Licenční a zkušební řádek uvádějí až tři servery a odkaz License page nebo Enter an email. Viz Licenční banner.

Jazyk

Použijte seznam jazyků (EN) v pravém horním rohu. Zobrazuje RU, EN, DE, PT a ES: ruština, angličtina, němčina, portugalština (Brazílie) a španělština.

  • Při první návštěvě konzole použije jazyk prohlížeče, pokud je v seznamu. Jinak použije angličtinu.
  • Prohlížeč uchovává vaši volbu jeden rok (cookie fbmonitor_lang).
  • Statistikové reporty se také řídí tímto jazykem.

Nastavení (ikona ozubeného kola)

Ikona ozubeného kola otevírá Settings. Hustota zobrazení, barevné schéma a demo režim

platí pouze pro tento prohlížeč. Stránka si zachovává název serveru a menu serveru, ze kterého jste přišli, takže se k němu můžete vrátit jediným kliknutím.

Settings: display density, color scheme and demo mode
Settings: display density, color scheme and demo mode

Co vidíte

  1. Záhlaví poslední stránky serveru (bez názvu serveru) a řádek s drobečkovou navigací Servers › Settings.
  2. Display density: čtyři možnosti, každá s krátkým popisem.
  3. Color scheme: tři možnosti.
  4. Demo mode: popis a zaškrtávací políčko Hide server and database names and paths.
  5. Console password: pouze v režimu jednoho uživatele, takže na obrázku není.

Vybraná možnost má modrý rámeček. Každé kliknutí se okamžitě uloží a konzole na chvíli zobrazí Saved. Prohlížeč si hustotu a barevné schéma pamatuje jeden rok. Demo mode zůstává v tomto prohlížeči zapnutý, dokud jej nevypnete.

  • Display density: jak velký je text a řádky tabulek na každé stránce. Popisky os a legendy grafů se řídí také podle ní.

    • Old style: původní vzhled.
    • Compact: menší text, těsnější řádky, více řádků na obrazovce.
    • Normal (výchozí): vyvážené velikosti textu.
    • Sparse: větší text a více prostoru.
  • Color scheme: Light (výchozí), Dark, High contrast (černý text a plné rámečky na bílém pozadí).

  • Demo mode: Hide server and database names and paths. Použijte jej, když konzoli ukazujete jiným lidem.

    • Názvy a cesty serverů, databází a procesů se změní na vymyšlená slova stejné délky.
    • IP adresy začínají na 192.168..
    • Protokoly a text SQL se také maskují. Textové hodnoty v SQL (v uvozovkách) se nahradí; názvy tabulek a sloupců zůstávají.
    • Volný text se maskuje na každé stránce: souhrn AI, zpráva o stavu, konfigurační soubory, stránky licence a clusteru, editor konfigurace a statistické zprávy. Klíče konfigurace zůstávají beze změny.
    • Řádek s drobečkovou navigací zobrazuje maskované názvy.
    • Pole formuláře zobrazuje maskovanou hodnotu, ale uchovává skutečnou. Pole, které má hodnotu, nelze upravovat, dokud je demo mode zapnutý.
    • Tlačítka pro kopírování cest a SQL jsou skrytá. Tlačítko Export CSV na stránce Errors je také skryté.
    • Mění se pouze obrazovka. Adresa v prohlížeči a data zůstávají beze změny. Režim je ve výchozím nastavení vypnutý.
  • Console password (pouze v režimu jednoho uživatele): mění heslo přihlášení do konzole.

    1. Zadejte Current password.
    2. Zadejte New password a Repeat the new password: alespoň 7 znaků, s písmeny a číslicemi.
    3. Klikněte na Change password.

    Agent uloží nové heslo jako hash do svého agent_config.json. To vyžaduje fbagent 2.80.0 nebo novější na stejném počítači. Všechny ostatní relace se odhlásí. Nesprávné aktuální heslo se počítá jako neúspěšné přihlášení, se stejným limitem jako na přihlašovací stránce. Změna se zapíše do auditního protokolu. Když konzole nemůže heslo změnit, blok uvede důvod; pak spusťte fbagent --reset-hqmonitor-password na hostiteli agenta.

Zprávy, které se mohou zobrazit (Console password)

Zpráva Co znamená
Password changed. Other sessions are signed out. Hotovo. Od této chvíle používejte nové heslo.
The current password is wrong. Zkontrolujte Current password.
The two new passwords are different. New password a Repeat the new password musí být stejné.
The new password is weak: use at least 7 characters with letters and digits. Zvolte delší heslo s písmeny a číslicemi.
The new password is the current one. Zvolte jiné heslo.
The new password is empty. / The new password is too long. Zadejte heslo běžné délky.
Too many attempts. Try again later. Příliš mnoho neúspěšných pokusů z vaší adresy. Počkejte až 15 minut.
The password cannot be changed here: … Konzole jej nemůže změnit (následuje důvod). Spusťte fbagent --reset-hqmonitor-password na hostiteli agenta.
The agent did not apply the new password; nothing was changed. Agent změnu odmítl. Staré heslo stále funguje.

Čas a časové pásmo

  • Stránky serveru zobrazují čas v časovém pásmu serveru, ne vašeho prohlížeče. Odznak poblíž ovládacích prvků času zobrazuje posun pásma, například UTC+03:00. Podržením myši nad odznakem zobrazíte název pásma.
  • Stránka Servers používá časové pásmo počítače s konzolí. Hodiny vpravo zobrazují aktuální čas v tomto pásmu. Viz Date and time range.
  • Většina stránek má stejné ovládací prvky času:
    • tlačítko data (Choose date, poté zvolené datum) otevře kalendář. Lze vybrat pouze dny, které mají data. Kalendář bez dat zobrazuje No data;
    • From a To nastavují časový rozsah v rámci daného dne, v minutových krocích. Pokud From není před To, To se posune na jednu minutu po From;
    • seznam předvoleb nastavuje typický rozsah. Selected se aktivuje, když nastavíte From a To ručně.
  • Rozsah nikdy nepřekračuje půlnoc.

Předvolby fungují na každé stránce jinak:

Stránka Předvolby Výchozí Jak předvolba nastavuje rozsah
Servers Last 6h, Last 12h, Full day Last 6h Počítá zpět od hodin pro dnešek, nebo od 23:59 pro minulý den.
Dashboard, Database, Metrics Last 1h, Last 6h, Last 12h, Full day Last 1h Počítá zpět od posledního datového bodu zvoleného dne.
Logs Full day, Last 1h, Last 6h, Last 12h Full day Last 1h končí u nejnovějšího záznamu. Last 6h je vždy 18:00–23:59, Last 12h je vždy 12:00–23:59.
Errors Full day, Last 1h, Last 6h, Last 12h Last 1h Last 1h končí u nejnovější chyby dne. Last 6h a Last 12h jako u Logs.

Conflicts, Perf Report a Clients Versions mají pouze tlačítko data a odznak časového pásma.

Stránky se samy neobnovují. Chcete-li vidět nová data, stiskněte F5 nebo změňte datum či časový rozsah.


3. Stránka Servers

Stránka Servers (/servers) je úvodní stránka. Uvádí každý server, který můžete vidět. V režimu více uživatelů účet vidí pouze servery, které mu přidělil jeho správce.

The Servers page
The Servers page

Co vidíte

  1. Záhlaví: logo s verzí, ikona ozubeného kola, Log out a seznam jazyků. Tato stránka nemá ← Servers ani řádek s drobečkovou navigací.
  2. Řádek licence, pouze když agent zastavil licenční úlohy nebo brzy končí zkušební období (viz Header and breadcrumb line).
  3. Horní řádek:
    • User management (správci v režimu více uživatelů, viz Users), Clusters (správci, viz Clusters), Licenses (všichni, viz Licenses), Updates a Notifications (všichni, viz Updates a Notifications);
    • ovládací prvky času: odznak časového pásma, datum, From — To, seznam předvoleb a hodiny (viz Date and time range).
  4. Řádek sekce: Servers s počtem serverů (zde 51), vyhledávací pole Search servers… a Collapse all.
    • Vyhledávání nachází text v názvu serveru nebo v cestě složky. Velká a malá písmena nerozhodují. Během vyhledávání číslo zobrazuje nalezené servery a všechny servery, například 1 / 51.
    • Collapse all zavře všechny otevřené řádky. Zobrazuje se pouze tehdy, když je řádek otevřený.
  5. Souhrnný řádek: kolik serverů má každou úroveň a kolik jich neposílá žádná data, například 2 serious · 22 warning · 2 ok · 25 no data.
  6. Tabulka serverů, jeden řádek na server. Dlouhý seznam se posouvá uvnitř tabulky. Servery, které neposílají žádná data, jsou dole.

Datum a časový rozsah

  • Odznak zobrazuje posun časového pásma počítače s konzolí, například UTC+03:00; název pásma je v jeho nápovědě. Hodiny vpravo zobrazují aktuální čas v tomto pásmu a aktualizují se každou sekundu.
  • Datum se otevírá na nejnovějším dni, který má data na některém serveru.
  • Předvolby jsou Last 6h (výchozí), Last 12h a Full day. Na této stránce není Last 1h. Pro dnešek předvolba počítá zpět od aktuálního času; pro minulý den od 23:59. Rozsah začíná nejdříve v 00:00. Full day je 00:00 až nyní (dnes) nebo 00:00 až 23:59.
  • Datum a časový rozsah platí pro otevřené řádky (pruh stavu a grafy) a pro den zprávy, kterou otevírá odznak stavu.
  • Sloupec Status vždy zobrazuje nejnovější stav agenta, k jakémukoli datu.

Tabulka

Sloupec Co zobrazuje
Server name Název agenta, odkaz Details na dashboard a datová složka serveru pod data_path. Dlouhý název nebo cesta se zkrátí uprostřed; najeďte na něj myší a zobrazí se celý.
DB Počet databází, nebo “—”, když jej agent nenahlásil.
Server/Agent version/Remote control První řádek: verze Firebird, například WI-V5.0.5.1880 Firebird 5.0 HQbird, a režim, ve kterém Firebird běží: SuperServer, SuperClassic nebo Classic. Druhý řádek: verze agenta, odkaz Jobs a stav doručení poslední změny konfigurace.
License Stav licence, který agent hlásí, a datum, které je pod ním rozhodující. Kliknutím otevřete stránku License daného serveru.
Status Odznak úrovně serveru (odkaz na zprávu), hlavní sdělení verdiktu agenta a stáří posledního stavu.

Server/Agent version/Remote control. Najeďte myší na buňku a zobrazí se obě verze v plném znění.

  • Režim pochází od agenta, fbagent 2.94.0 nebo novější. U staršího agenta řádek zobrazuje pouze verzi.

  • Když firebird.conf nastavuje jiný režim, zobrazí jej šipka, například SuperServer → Classic. Najeďte myší na šipku: “firebird.conf sets Classic: it takes effect after a Firebird restart”.

  • Jobs otevírá editor konfigurace. Zobrazuje se pouze tehdy, když konzole může pro tento server otevřít editor.

  • Odznak doručení ukazuje, jak daleko se poslední změna konfigurace dostala: SENT, TAKEN, APPLIED, RESTART NEEDED, REJECTED, ALREADY SET, SUPERSEDED, UNKNOWN nebo NOT READ. Viz Delivery status.

  • Za odznakem: push 11:10 · ack 11:10, čas odeslání změny a čas, kdy ji agent potvrdil. Tyto časy jsou v časovém pásmu konzole. DRIFT 15′ znamená, že agent 15 minut neodpověděl.

  • Najeďte myší na odznak a zobrazí se důvod agenta a přesné časy.

  • “—”: tomuto serveru nebyla nikdy odeslána žádná změna konfigurace.

  • HQCenter link is not set: konzole nemůže zobrazit doručení. Najeďte na něj myší a zobrazí se důvod.

License. Odznak zobrazuje stav, například LICENSED, UNLICENSED nebo NO DATA.

  • Pod odznakem: datum, které je pro stav rozhodující, například datum vypršení platnosti nebo konec zkušebního období. Když zbývá 60 dní nebo méně, následují dny, například 2026-12-01 (26 d).
  • ⚠ za odznakem: zpráva agenta o licenci je starší než 72 hodin.
  • Najeďte myší na buňku a zobrazí se důvod, zákazník, Enforcement is off: nothing is blocked., když tomu tak je, a Jobs that need a license: N.

Status. Odznak úrovně (viz Status colors),

headline a stáří stavu.

  • Odznak je úroveň serveru podle verdiktu agenta (schéma fbagent 26 nebo novější). Starší agent žádný verdikt neposílá: odznak pak zobrazuje svou starou závažnost.
  • Když je horší úroveň samotného agenta, zobrazí se druhý malý odznak, například Agent: WARNING. Problémy agenta (fronta nahrávání, zdroje, samoaktualizace) úroveň serveru nemění.
  • Kliknutím na odznak otevřete zprávu o stavu serveru nejnovějšího snímku vybraného dne.
  • Pod odznakem: titulek verdiktu, například „no registered backups for employee.fdb“. Ukázáním na něj zobrazíte celý text.
  • Poslední řádek je stáří stavu, například 9 min ago. Ukázáním na něj zobrazíte celý čas. Když se časové pásmo agenta liší od časového pásma konzole, popisek také zobrazí posun agenta v daném čase.
  • no data since <time>: nejnovější stav je starší než 30 minut (3 cykly agenta). Odznak je šedý a zobrazuje čas posledního stavu, nikoli úroveň. Řádek nemá titulek. Kliknutím na odznak otevřete poslední den s daty.
  • Změna jazyka překreslí odznaky a souhrnný řádek.

Barvy stavů

Stav vypočítává agent. Konzole jej pouze zobrazuje.

Odznak Barva Význam
CRITICAL, SERIOUS Červená Závažný problém. Jednejte hned.
WARNING, MINOR Oranžová Něco vyžaduje pozornost.
OK Zelená Nejsou nalezeny žádné problémy.
INFO, — Šedá Žádný stav nebo informativní stav.

| no data since … | Šedá | Agent neposlal stav po dobu delší než 30 minut. |

Stav pochází z nejnovějšího stavového souboru agenta. Šedý odznak no data since znamená, že agent přestal posílat data.

Otevření řádku serveru

Kliknutím na řádek (nebo na trojúhelník vlevo od něj) jej otevřete. Dalším kliknutím jej zavřete. Můžete otevřít několik řádků. Odkazy v řádku (Details, Jobs, odznak licence, odznak stavu) řádek neotevřou.

Otevřený řádek zobrazuje pro vybrané datum a časový rozsah:

  1. SERVER STATE BY SERVER_STATUS SNAPSHOTS: pruh stavů.
  2. CPU LOAD / LOAD AVERAGE / MEMORY: graf.
  3. CONNECTIONS & DATABASES: graf.
A server row with its charts
A server row with its charts

Pruh stavů je pruh barevných buněk, jedna buňka pro každý stavový snímek agenta (nebo pro skupinu snímků, když je rozsah dlouhý; skupina přebírá barvu svého nejhoršího snímku). Časové popisky pod pruhem jsou v časovém pásmu serveru.

  • zelená, oranžová, červená: úroveň serveru daného snímku (OK, WARNING, SERIOUS). Problémy agenta (fronta, zdroje, aktualizace) pruh nebarví.
  • šrafovaná: v daném čase nejsou žádné snímky (agent neposlal data).
  • prázdná: žádná data (před nejstarším snímkem nebo v budoucnosti).

Ukázáním na buňku zobrazíte čas, úroveň, titulek a problémové oblasti, například 10:20–10:30 · SERIOUS · … · Disk speed, Locks. Kliknutím na buňku otevřete zprávu o stavu serveru daného snímku.

  • S klávesnicí: Tab na pruh, poté šipky, Home a End. Enter otevře zprávu, Escape skryje nápovědu.
  • Na dotykové obrazovce první klepnutí zobrazí nápovědu, druhé klepnutí otevře zprávu.

Odznak stavu i pruh zobrazují úroveň serveru. Úroveň agenta je pouze malý odznak Agent:.

Grafy také používají časové pásmo serveru. Když se pásmo serveru liší od pásma konzole, časy pod pruhem a grafy se liší od rozsahu v horní části. Na obrázku jsou obě pásma UTC+03:00, takže rozsah 00:00–02:44 je na obou hodinách stejný. Předvolba je Last 6h, ale rozsah začíná v 00:00, na začátku dne.

  • CPU Load / Load Average / Memory: legenda CPU %, Load Avg, RAM %. CPU v procentech (sloupce), průměrné zatížení a paměť v procentech (čáry), na škále 0–100. Sloupec CPU je zelený do 70 %, oranžový od 70 % do 90 % a červený od 90 %. Minuta bez dat nemá sloupec. Nápověda k čáře paměti také zobrazuje použitou a celkovou RAM, například RAM %: 63 (10.1 GB / 16.0 GB). Windows nemá průměrné zatížení: graf je CPU Load / Memory, bez této čáry.
  • Connections & Databases: legenda Connections a Databases. Počet připojení a aktivních databází.

Ukázáním na graf zobrazíte všechny hodnoty dané minuty v poli nad grafem. Když změníte datum nebo časový rozsah, všechny otevřené řádky se znovu načtou.

Zprávy na stránce Servers

Zpráva Co znamená
No server_status snapshots for this interval Pruh nemá v rozsahu žádné stavové snímky nebo je nelze načíst. Zvolte delší rozsah nebo jiné datum.
Loading… Graf se načítá.
No data Graf nemá v rozsahu žádná data.
Error Data grafu nelze načíst. Stiskněte F5.
No data / cannot load servers Seznam serverů nelze načíst. Následuje text chyby. Stiskněte F5; pokud problém přetrvává, obraťte se na správce.
Waiting for the first data from the agent Žádný server dosud do této konzole neposlal data, například hned po nové instalaci. Trvá to 1–2 minuty. Stránka kontroluje znovu každých 10 sekund a sama otevře tabulku, jakmile se server objeví.
Still no data after 5 minutes. Check that the HQbird agent service is running and that it sends data to this console. Zobrazí se pod výše uvedenou zprávou po 5 minutách. Zkontrolujte službu agenta a její adresu konzole.
„—“ ve sloupci Status Konzole nemůže přečíst stavový soubor tohoto serveru (dosud žádný nebo je poškozený).
no data since <time> (Status) Nejnovější stav tohoto serveru je starší než 30 minut. Zkontrolujte, že služba agenta běží a posílá data.
NO DATA (License) Agent neohlásil stav licence.
HQCenter link is not set (Remote control) Konzole nemůže zobrazit doručení konfigurace. Ukázáním na text zobrazíte důvod.

Tipy

  • Napište část názvu do pole Search servers… a najděte server v dlouhém seznamu.
  • Šedý odznak no data since znamená, že agent přestal posílat data. Otevřete řádek: šrafované buňky v pruhu ukazují, kdy přestal.
  • Souhrnný řádek počítá servery podle úrovně. Servery bez dat jsou ve spodní části tabulky.
  • Chcete-li porovnat zatížení několika serverů, otevřete jejich řádky pod sebou.

4. Server dashboard

Dashboard (/dashboard?server=<name>) zobrazuje jeden server. Otevřete jej odkazem Details na stránce Servers. Stránka se otevírá s dnešním dnem a časovým rozsahem Last 1h.

The server dashboard with all cards closed
The server dashboard with all cards closed

Co vidíte (obrázek ukazuje ručně nastavený rozsah 08:00–20:00, takže seznam předvoleb zobrazuje Selected):

  1. Záhlaví: ← Servers, název serveru a nabídka nástrojů serveru (viz Header).
  2. Řádek s drobečkovou navigací: Servers › SRV.
  3. Časová lišta. Vlevo: verze Firebird a Root. Vpravo: Server status s odznakem a titulkem, časové pásmo, datum, počáteční a koncový čas a předvolba času.
  4. Dva grafy, které jsou vždy otevřené: CPU % / Load Avg / RAM % a Connections / Databases.
  5. Karty, které můžete otevírat a zavírat: CPU usage details (10 min), Who uses the disk (10 min), Who uses memory (10 min), Temp files, Disk space, Read/write latency se seznamem disků a Read/write speed.
  6. Tabulka databází: Databases s jejich počtem, vyhledávací pole a jeden řádek pro každou databázi.

Časová lišta:

  • Verze Firebird, například LI-V4.0.5 Firebird 4.0. Zobrazuje —, když verze není známa.
  • Root: složka Firebird na serveru, například /opt/firebird. Skryje se, když ji agent neposlal.
  • Server status: viz Server status.
  • Časové pásmo serverových časů na stránce. Viz Time and time zone.
  • Tlačítko data: vyberte jiný den v kalendáři.
  • Počáteční a koncový čas: nastavte rozsah ručně.
  • Předvolba času: Last 1h (výchozí), Last 6h, Last 12h, Full day a Selected. Selected je aktivní pouze poté, co ručně nastavíte počáteční nebo koncový čas.

Zavřené a otevřené karty

Zavřít lze sedm karet: CPU usage details, Who uses the disk, Who uses memory, Temp files, Disk space, Read/write latency a Read/write speed. Všechny se otevírají zavřené: jeden tenký řádek s názvem a More. Obrázek výše ukazuje toto výchozí zobrazení. Obrázek níže ukazuje stejnou stránku se všemi otevřenými kartami.

The server dashboard with all cards open
The server dashboard with all cards open
  • Chcete-li kartu otevřít, klikněte na její řádek s názvem nebo na More.
  • Chcete-li ji zavřít, klikněte na Less nebo znovu na řádek s názvem.
  • Prohlížeč uchovává seznam otevřených karet v cookie fbmonitor.dashboard.open po dobu 365 dní. Seznam je stejný pro všechny servery: karta otevřená na jednom serveru je otevřená i na ostatních serverech.
  • Řádek pod názvem (čas snímku, CPU hostitele, RAM a tak dále) se zobrazuje pouze tehdy, když je karta otevřená.
  • Seznam disků karty Read/write latency zůstává v řádku s názvem, i když je karta zavřená. Disk můžete vybrat bez otevření karty. Kliknutí na seznam kartu neotevře ani nezavře.
  • Karta se zobrazí pouze tehdy, když má data. Například agent, který neposílá seznam programů, nezobrazuje kartu CPU usage details.

Rozvržení. Od šířky 769 px stojí karty ve dvou stejných sloupcích. Who uses the disk zůstává v pravém sloupci, i když se CPU usage details nezobrazuje. Who uses memory zabírá celou šířku. Na telefonu je v řádku jedna karta.

  • ← Servers vlevo vás vrátí na seznam serverů. Toto tlačítko mají i všechny ostatní stránky serveru.
  • Název serveru.
  • Nabídka nástrojů serveru: Logs, Configs, Errors, Conflicts, Perf Report, Jobs a Backups. Jobs a Backups se zobrazují pouze tehdy, když je dostupná konfigurace agenta tohoto serveru. Na ostatních stránkách serveru nabídka označuje stránku, na které se nacházíte.
  • Vpravo: ikona ozubeného kola (viz Settings (gear icon)), Log out a seznam jazyků.
  • Řádek s drobečkovou navigací pod záhlavím: Servers › SRV na dashboardu, Servers › SRV › Logs na stránce nástroje. Každý krok kromě posledního je odkaz; Servers vás vrátí na seznam serverů.
  • Pod řádkem s drobečkovou navigací se může zobrazit červený nebo žlutý banner licence, když server nemá licenci nebo jeho zkušební verze brzy skončí.

Server status

Server status v časové liště otevře zprávu o stavu serveru nejnovějšího stavového snímku ve vybraném rozsahu.

  • Odznak vedle něj je úroveň daného snímku, například WARNING. Ukázáním na něj zobrazíte Last snapshot: HH:MM.

  • Za odznakem jeden řádek zobrazuje titulek daného snímku a systémy s nálezy, například „vbackup job … failed on …“. Ukázáním na něj zobrazíte celý text. Kliknutím na něj otevřete zprávu daného snímku. V demo režimu jsou názvy v něm maskovány.

  • Když rozsah neobsahuje žádný snímek, není zde žádný odznak ani titulek. Odkaz pak otevře zprávu vybraného dne.

  • Pruh snímků za minutu je na stránce Servers a v samotném reportu.

Grafy serveru

Grafy nemají na ose hodnot čísla, pouze časy pod ní: najeďte na graf a uvidíte hodnoty s jejich jednotkami. Legendy jsou krátké, protože nadpis karty už říká, co graf je. Najeďte na položku legendy a uvidíte její celý název.

Najeďte na graf a uvidíte všechny hodnoty dané minuty. Pole se zobrazuje nad grafem, takže nepřekrývá čáry (pod ním, když nad ním okno nemá místo).

Hlášení, která se mohou zobrazit:

Hlášení Co znamená
No data / cannot load dashboard Konzole nemohla načíst data tohoto serveru. Pole uvádí Requests a Diagnostics: jeden řádek na zdroj dat s OK nebo MISSING. Zkontrolujte, že agent odesílá data.

CPU % / Load Avg / RAM %

Vždy otevřeno. Jeden bod za minutu.

Čára Co ukazuje
CPU % Zatížení procesoru hostitele jako sloupce. Sloupec je zelený do 70 %, oranžový od 70 % do 90 % a červený od 90 %. Šedá znamená žádná data.
Load Avg Průměrné zatížení hostitele. Windows nemá průměrné zatížení: žádná čára a žádná položka legendy.
RAM % Využití paměti. Tip přidává použitou a celkovou paměť, například RAM %: 63 (10.1 GB / 16.0 GB).
New RAM % basis Přerušovaná jantarová čára v minutě, kdy agent změnil způsob počítání RAM %. Položka legendy se zobrazí jen tehdy, když rozsah takovou minutu obsahuje.
  • Na Linuxu agent počítá použitou paměť jako total − available, takže tmpfs a sdílená paměť jsou v ní zahrnuty (fbagent 2.93.0 a novější).
  • Agent, který ji počítal starým způsobem, přejde na nový základ při aktualizaci. Tip v této minutě říká: The agent changed how RAM % is counted (now: total − available). The step here is not a change of memory use. Stejná značka je na grafu Memory by kind v části Who uses memory.

Connections / Databases

Vždy otevřeno. Jeden bod za minutu.

Čára Co ukazuje
Connections Počet připojení ke všem databázím serveru.
Databases Počet aktivních databází.

CPU usage details

Karta CPU usage details (10 min) ukazuje, jak hostitel využíval procesor v 10 minutách před jedním snímkem stavu serveru:

  • bez vybrané minuty: nejnovější snímek rozsahu;
  • s vybranou minutou: snímek, jehož 10 minut tuto minutu obsahuje.

Karty Who uses the disk a Who uses memory používají stejný snímek.

The CPU usage details card
The CPU usage details card

Co vidíte:

  1. Řádek 10 minutes to 20:00 · Host CPU 1.9%: konec 10 minut a průměrné CPU celého hostitele. Host CPU unknown, když ho agent nemohl přečíst.
  2. Sloupec CPU hostitele s legendou: Firebird, Agent, Other, Short a Idle, každý se svým procentem. Short jsou procesy, které začaly a skončily mezi dvěma průchody agenta: příliš krátké na pojmenování. Idle se zobrazuje jen tehdy, když je CPU hostitele známé.
  3. Tabulka programů (viz sloupce níže).
  4. Na Linuxu: Firebird disk IO: read 57.9 KiB/s, write 811.2 KiB/s, čtení a zápis na disk procesů Firebird. Zápis je —, když ho agent neodeslal (agent před 2.89.0, nebo první minuty po aktualizaci).
  5. CPU by kind over the range: stejné rozdělení CPU pro každý snímek rozsahu, jako skládané plochy Firebird, Agent, Other a Short, s čárou Host (CPU hostitele).
Sloupec Co ukazuje
Program Název programu. Řádek Firebird je zvýrazněn.
Kind Firebird, agent, kernel nebo other.
Processes Kolik procesů tohoto programu běželo.
CPU avg Průměrné CPU programu v 10 minutách, v % celého hostitele.
CPU max Nejvyšší CPU programu v 10 minutách, v % celého hostitele.
Memory Paměť, kterou procesy programu drží (RSS).
% RAM Tato paměť v % RAM hostitele.

Hlášení, která se mohou zobrazit:

Hlášení Co znamená
This snapshot has no list of programs (an older agent, or system_metrics.programs is off). Jiné snímky rozsahu seznam mají, tento ne. Vyberte jinou minutu, aktualizujte agenta nebo zapněte přepínač.
  • Karta potřebuje fbagent 2.89.0 nebo novější a přepínač CPU and memory by program (system_metrics.programs) na kartě Settings konfigurace agenta.
  • Když žádný snímek rozsahu seznam nemá, karta se nezobrazuje.

Who uses the disk

Karta Who uses the disk (10 min) ukazuje, kdo přenesl bajty jednoho disku v 10 minutách snímku CPU usage details. Disk je ten, který vyberete v seznamu Read/write latency.

The Who uses the disk card
The Who uses the disk card

Obrázek ukazuje kartu na linuxovém serveru, kde je IO accounting vypnuté: karta to říká a uvádí příkaz, který ho zapne (viz hlášení níže).

Co vidíte, když má agent data:

  1. Řádek 10 minutes to 19:50 · disk sda: read 38.5 KiB/s, write 15.7 MiB/s · by systemd service: konec 10 minut, čtení a zápis celého disku a zdroj řádků. by systemd service na Linuxu (řádek je systemd služba), by process (ETW) na Windows (řádek je proces).
  2. Tabulka (viz sloupce níže).
  3. Řádek Not in the rows: 2.1 MiB/s (other services, the kernel): bajty disku, které žádný řádek nevysvětluje.
Sloupec Co ukazuje
Service Služba nebo proces. Řádek Firebird je zvýrazněn.
Kind Firebird, agent, other nebo user session. · shared znamená, že v stejné skupině běží jiné programy, takže tyto bajty nejsou jen z této služby.
Programs Programy daného řádku. Najeďte na buňku a uvidíte celý seznam.
Read/s Přečtené bajty za sekundu.
Write/s Zapsané bajty za sekundu.
% of disk Podíl řádku na všech bajtech disku.

Hlášení, která se mohou zobrazit:

Hlášení Co znamená
IO accounting is off, so the agent cannot see who uses the disk. Turn it on: sudo systemctl set-property <unit> IOAccounting=yes Linux nepočítá IO po službách. Spusťte příkaz jednou na serveru. Unit je služba agenta; <agent unit>, když ji konzole nezná.
Needs cgroup v2: this host runs cgroup v1. Hostitel používá starý systém cgroup. Karta tam nemůže fungovat.
No cgroup v2 file system is mounted: the agent cannot see who uses the disk. Připojte souborový systém cgroup v2 nebo použijte hostitele, který ho má.
The agent could not start its ETW session (it needs administrator rights). Windows: spusťte službu agenta s právy správce.
The ETW session lost events: no table for these 10 minutes. Windows: počty nejsou úplné, takže karta nezobrazuje tabulku. Vyberte jinou minutu.
Not measured: {reason} Agent nemohl tento disk změřit. Důvod následuje.
No data for this disk in these 10 minutes. Snímek má řádky pro jiné disky, ne pro vybraný.
  • Karta potřebuje fbagent 2.90.0 nebo novější a přepínač Disk IO by service (disk_io.by_service) na kartě Settings.
  • Karta se nezobrazuje, když je řádek Read/write latency skrytý, nebo když snímek nemá ani řádky, ani důvod.

Who uses memory

Karta Who uses memory (10 min) ukazuje, kdo drží RAM, ze snímku CPU usage details. Zaujímá plnou šířku pod kartami CPU a disku.

The Who uses memory card
The Who uses memory card

Co vidíte:

  1. Řádek pod nadpisem.
    • Linux: 10 minutes to 20:00 · RAM 24.5 GiB: used 6.5 GiB (26.6%) · swap 504.1 MiB of 4.0 GiB · waits for memory: some 0.0%, full 0.0% · by systemd service. waits for memory je podíl času, kdy některé nebo všechny procesy čekaly na paměť (PSI).
    • Windows: 10 minutes to 19:50 · RAM 16.0 GiB: available 6.1 GiB, used 62.0% · commit 11.2 GiB of 20.0 GiB · by program.
  2. Sloupec celé RAM s legendou.
    • Linux: Firebird, agent, Other services, File cache, Kernel and the rest a Free. Části služeb nezahrnují jejich file cache. Kernel and the rest je jádro, paměť, kterou žádná služba nemá naúčtovanou, a služby pod prahem řádku.
    • Windows: Firebird, agent, Other programs, System file cache, System and shared pages a Available. Části programů jsou jejich privátní pracovní sady.
  3. Tabulka služeb (Linux) nebo programů (Windows). Viz sloupce níže.
  4. Řádek pod tabulkou:
    • Below the row threshold: {bytes}: služby, které jsou příliš malé na řádek. Řádek jiné služby potřebuje 64 MiB, nebo 1 % RAM, když je to méně. Tabulka má nejvýše 8 řádků.
    • Other services: {bytes} (the names are off: system_metrics.programs): přepínač CPU and memory by program je vypnutý, takže řádky mají jen Firebird a agent.
    • Not charged to any service: {bytes} (Linux): paměť, která nepatří žádné službě.
  5. Databases in the OS cache (Linux): viz níže.
  6. Memory by kind over the range, % RAM: viz níže.

Sloupce Linuxu (řádek je systemd služba):

Sloupec Co ukazuje
Service Služba systemd. Řádek Firebird je zvýrazněn. · gone znamená, že služba není v nejnovější minutě: čísla jsou z poslední minuty, která ji uváděla.
Kind Firebird, agent, other nebo user session. · shared: v stejné skupině běží jiné programy. · limit X: tvrdý limit paměti služby. · high X: její měkký limit (jádro službu nad ním zpomaluje).
Programs Programy služby.
Total Veškerá paměť naúčtovaná službě.
Processes Paměť jejích procesů.
File cache File cache naúčtovaná službě.
tmpfs/shm Soubory v paměti a sdílená paměť.
Kernel Paměť jádra naúčtovaná službě.
Swap Část její paměti ve swapu.
% RAM Paměť v % RAM hostitele.
Peak 10 min Nejvyšší paměť služby v 10 minutách.
OOM Kolik procesů zastavil out-of-memory killer. Najeďte na to a uvidíte programy, které byly pravděpodobně zastaveny.
PSI some Podíl času, kdy některé procesy služby čekaly na paměť. Najeďte na to a uvidíte podíl, kdy čekaly všechny.

Sloupce Windows (řádek je program):

Sloupec Co ukazuje
Program Program. Řádek Firebird je zvýrazněn.
Kind Firebird, agent nebo other, se stejnými značkami jako na Linuxu.
Services Až 3 služby Windows daného programu.
Processes Kolik procesů programu běželo.
Committed Privátní paměť, kterou program potvrdil.
Private WS Privátní část jeho pracovní sady.
Working set Jeho celá pracovní sada včetně sdílených stránek.

| Kernel pools | Paměť jádra programu. | | % RAM | Paměť v % paměti RAM hostitele. | | Peak 10 min | Nejvyšší paměť programu za 10 minut. |

Porovnání s MON$. Firebird sám hlásí paměť, kterou přidělil (MON$MEMORY_USAGE). Klikněte na buňku Processes (Linux) nebo Committed (Windows) v řádku Firebird. Tip porovná obě čísla. Zobrazí se pouze tehdy, když existuje právě jeden řádek Firebird a agent načetl MON$ v 10 minutách snímku.

Kdo drží souborovou cache. Linux účtuje stránku souborové cache službě, která ji přečetla jako první. Záloha tedy může držet velkou část cache databáze.

Databáze v cache OS (Linux 6.5 a novější): kolik z každého databázového souboru drží cache OS. Tabulka má nejvýše 8 řádků, největší cache první.

Sloupec Co ukazuje
Database Název databáze. Klikněte na něj pro zobrazení cesty. · O_DIRECT znamená, že Firebird otevírá tento soubor s O_DIRECT: jeho stránky nejsou v cache OS.
File Velikost souboru.
In the OS cache Kolik ze souboru drží cache.
% of file Totéž v % ze souboru.
Dirty Změněné stránky, které ještě nejsou na disku.
Recently evicted Kolik cache nedávno uvolnila.

Pod tabulkou: Other database files: {files}, {bytes} in the cache. a The OS cache is shared: the kernel gives it back when programs need memory.

Memory by kind over the range, % RAM: rozdělení paměti RAM pro každý snímek rozsahu jako skládané oblasti Firebird, Agent, Other (ostatní služby), Cache (souborová cache) a Kernel (jádro a zbytek), od 0 do 100 %. Čára Used je RAM %. New RAM % basis označuje minutu, kdy agent změnil způsob počítání RAM %. Rozdělení mají pouze snímky z fbagent 2.93.0 a novější, takže starší minuty jsou prázdné.

Zprávy, které se mohou zobrazit:

Zpráva Co znamená
Memory accounting is off, so the agent cannot see which service holds the memory. Turn it on: sudo systemctl set-property <unit> MemoryAccounting=yes Linux nepočítá paměť pro jednotlivé služby. Spusťte příkaz jednou na serveru.
Needs cgroup v2: this host runs cgroup v1. Hostitel používá starý systém cgroup. Tabulka zde nemůže fungovat.
No cgroup v2 file system is mounted: the agent cannot see which service holds the memory. Připojte souborový systém cgroup v2.
The agent could not read the process list in these 10 minutes. Agent nemohl vypsat procesy. Vyberte jinou minutu.
This snapshot has no memory by service (an older agent, or system_metrics.memory_by_service is off). Aktualizujte agenta nebo zapněte přepínač.
The kernel has no cachestat (Linux 6.5+ is needed): the OS cache of the databases is not measured. Jádro je starší než 6.5. Databases in the OS cache zůstává prázdné.
no access to the file (v řádku) Agent nemůže tento databázový soubor otevřít.
the file is gone (v řádku) Databázový soubor již neexistuje.
  • Karta vyžaduje fbagent 2.93.0 nebo novější a přepínač Memory by service (system_metrics.memory_by_service) na kartě Settings tab.
  • Karta se nezobrazí, když snímek nemá paměťová data ani důvod a rozsah nemá žádné rozdělení paměti k vykreslení.

Temp files

Dočasné soubory Firebird: kolik jich je a jak jsou velké, jeden bod za minutu.

Položka legendy Co ukazuje
Count Počet dočasných souborů. Tip uvádí druhy souborů, nejvíce souborů první: dočasné soubory podle předpony názvu (fb_sort, fb_blob, fb_undo, …) a soubory vlastní složky zámků Firebird (fb_lock, fb_monitor, fb_trace, …). Počet zahrnuje obojí.
Size Velikost dočasných souborů.
Disk, MiB/s (sda, with DB) Rychlost disku s dočasnou složkou: čtení + zápis, MiB za sekundu (součet, když je dočasná složka na několika discích). with DB znamená, že databáze jsou na stejném disku.
  • Temp files in memory: no disk line: dočasná složka je v paměti, takže se čára disku nezobrazuje.
  • Temp disk not measured: {disk} network disk (nebo no counters): agent nemá pro dočasnou složku diskové čítače.
  • Agenti bez úlohy diskového IO nezobrazují čáru disku ani položku legendy.

Disk space

Jeden pruh na disk: využité a volné místo v procentech, s velikostmi pod procenty. Data pocházejí z posledního diskového snímku zvoleného dne.

  • Klikněte na pruh pro zobrazení přípojného bodu, Disk space used, Disk space free a Disk size.
  • Cesty vpravo jsou složky na daném disku, které agent sleduje. Zobrazí se až 5; More zobrazí všechny, Less je skryje.
  • Agent starší než pole velikosti zobrazuje pouze procenta.
Zpráva Co znamená
No disk usage data for the selected day. Agent neposlal pro zvolený den žádný diskový snímek.

Read/write latency

Pro jeden disk s databázemi nebo dočasnými soubory Firebird: průměrná doba čtení a zápisu v minutě a operace za sekundu.

Seznam disků je v řádku názvu. Každá položka je disk s jeho rolí, například sda (databases, temp). Disky s databázemi jsou první. Seznam je zakázán, když má server jeden disk. Vaše volba také mění Read/write speed a Who uses the disk.

Položka legendy Co ukazuje
Read Latence čtení v ms.
Write Latence zápisu v ms.
IOPS Operace za sekundu. Tip doplňuje, jak byl disk vytížený, například IOPS: 120 (busy 35%).
Agent task Žlutý pás v minutách, kdy běžela některá z náročných úloh agenta po dobu 5 sekund nebo déle: test rychlosti disku, záloha, obnova, sweep, validace, úplná statistika nebo přepočet indexů. Tip úlohu pojmenuje. Pomalé minuty uvnitř pásu pocházejí od agenta, ne od uživatelů.
  • Pro agenty bez úlohy diskového IO nebo když nebyl měřen žádný disk, neexistuje řádek s Read/write latency a Read/write speed.

Read/write speed

Stejný disk: přečtené a zapsané bajty za sekundu.

Položka legendy Co ukazuje
Read Přečtené bajty za sekundu na disku.
Write Zapsané bajty za sekundu na disku.
Firebird, read, all disks Přerušovaná čára: co procesy Firebird přečetly na celém serveru, nejen na tomto disku (Linux).
Firebird, write, all disks Přerušovaná čára: co procesy Firebird zapsaly na celém serveru (Linux).
  • Když agent vidí služby disku (Who uses the disk) pro každou minutu grafu, přerušované čáry jsou IO Firebird pouze na tomto disku. Legenda pak uvádí Firebird, read a Firebird, write; klikněte na položku legendy pro zobrazení Firebird reads per second, this disk. Tip uvádí zdroj každé minuty.
  • Když jsou čáry Firebird mnohem nižší než čtení nebo zápisy disku, disk zatěžuje jiný program.
  • Zápisy Firebird nezahrnují data dočasných souborů smazaných předtím, než se dostala na disk (třídicí soubory, sdílená paměť). Tip to zobrazuje jako Firebird, dropped before the disk. Agenti před 2.89.0 to počítali, takže u nich se čára zápisu nevykresluje.
  • Pod grafem: Not measured: s dočasnými nebo databázovými složkami, které nemají diskové čítače (in memory, network disk, no counters).
  • Ve Windows pouze čára čtení, pro tento disk: zápisy přes cache patří systému.

Select a minute

Klikněte na libovolný bod v libovolném grafu, také v grafech otevřeného řádku databáze. Konzole:

  • vykreslí v této minutě modrou čáru na všech grafech;
  • zobrazí Selected minute: HH:MM vedle vyhledávacího pole, s odkazem Report for this minute, když tuto minutu pokrývá snímek stavu: zpráva o stavu daného snímku;
  • přepne CPU usage details, Who uses the disk a Who uses memory na snímek, jehož 10 minut obsahuje tuto minutu;
  • načte data trasování a připojení pro tuto minutu v každém otevřeném řádku databáze.

Změna data, časového přednastavení nebo počátečního či koncového času vymaže vybranou minutu.

Databases table

The databases table of the dashboard
The databases table of the dashboard

Co vidíte:

  1. Databases a jejich počet.
  2. Search by name or path…: psaním filtrujte seznam.
  3. Selected minute: HH:MM a Report for this minute, když je vybrána minuta.
  4. Collapse all: zavře všechny otevřené řádky. Zobrazuje se pouze tehdy, když je nějaký řádek otevřený.
  5. Jeden řádek na databázi. Kliknutím na řádek jej otevřete (viz Open a database row).
Sloupec Co ukazuje
Database(Name) Název databáze, u dlouhého názvu zkrácený uprostřed (kliknutím zobrazíte celý název). Pod ním: odznaky stavu. Details otevře database pages se stejným datem a časovým rozsahem.
Statistics Odznaky z nejnovějšího snímku gstat (viz níže).
Path · Size / Page size · Dialect · Creation date · Owner První řádek: cesta k databázovému souboru, tlačítko kopírování, velikost, štítek Sweep a štítek zabezpečení. Druhý řádek: velikost stránky, SQL dialekt, datum vytvoření a vlastník.
Conns Připojení v posledním snímku rozsahu. Kliknutím zobrazíte As of HH:MM:SS. — znamená žádná data pro tuto databázi v rozsahu. Kliknutím na záhlaví seřadíte.
  • Path: dlouhá cesta je zkrácena uprostřed. Tlačítko kopírování (Copy path) ji zkopíruje; v demo režimu je skryté.
  • Size je velikost všech databázových souborů na disku z nejnovějšího měření ve vybraném rozsahu. Je v MB pod 1024 MB a v GB nad tím. Kliknutím zobrazíte přesný počet bajtů. Databáze bez tohoto měření nezobrazuje velikost.
  • Owner je vlastník databáze (MON$OWNER). — označuje prázdné pole na druhém řádku.
  • Štítek zabezpečení ukazuje, kde se ověřují přihlášení k databázi, když to není vlastní bezpečnostní databáze serveru: sec: <file> pro soukromou bezpečnostní databázi, self, když databáze ověřuje vlastní přihlášení.
  • Vlastník a štítek zabezpečení vyžadují fbagent 2.78.0 nebo novější.

State badges and the Sweep chip

Odznak stavu pod názvem se zobrazí, když databáze není v normálním stavu:

Odznak Barva
Full shutdown červená
Single-user shutdown, Multi-user shutdown, Shutdown (maintenance), nbackup lock jantarová
nbackup merge, Replica (read-only), Replica (read-write), Replica, Read only modrá
  • Kliknutím na odznak zobrazíte jeho zdroj: From the database header, HH:MM nebo From MON$DATABASE, HH:MM. Vyhrává novější z obou.
  • stale se přidá a odznak se ztlumí, když je vzorek o více než 15 minut starší než konec rozsahu.
  • Databáze v úplném vypnutí nemá žádná připojení, takže ji agent vypisuje z její hlavičky.

Štítek Sweep za velikostí ukazuje interval automatického sweepu z hlavičky databáze: Sweep 20000 nebo Sweep off (přerušovaný okraj), když je interval 0. Kliknutím zobrazíte celý text.

Odznaky stavu z hlavičky a štítek Sweep vyžadují fbagent 2.91.0 nebo novější.

Statistics badges

  • critical - {n} (červená) a warnings - {n} (jantarová): problémy, které analyzátor statistik našel v nejnovějším snímku gstat. Kliknutím na odznak zobrazíte čas a soubor snímku. Kliknutím jej otevřete na stránce Statistics na kartě Analysis and Recommendations.
  • +25% in {n} days: nejrychleji rostoucí tabulka nebo index vzroste o 25 % za tolik dní. Kliknutím zobrazíte objekt, datum a růst za den. Odznak je šedý a červený, když je to 30 dní nebo méně. Kliknutím otevřete Trends › Forecasts s nejjemnější citlivostí.

Zprávy, které se mohou zobrazit:

Zpráva Co znamená
No data / cannot load databases Seznam databází se nenačetl. Následuje text chyby.
— v Conns Žádná data o připojeních pro tuto databázi v daném rozsahu.

Otevření řádku databáze

Klikněte na řádek databáze. Zobrazí se dva grafy:

  • Transactions: Next-Oat, OST − OIT a Active Δ (viz Čítače transakcí).
  • LWM: aktivní připojení (activeAtt), aktivní požadavky (activeReq), doba provádění (execTime Δ), načítání a chyby, za minutu.

Kliknutím na položku legendy její čáru skryjete nebo zobrazíte.

An open database row with a selected minute
An open database row with a selected minute

Otevřené mohou být nejvýše 3 řádky databází. Otevřením 4. se zavře nejstarší.

Když je vybrána minuta, otevřený řádek zobrazí také dvě tabulky. Každá tabulka zobrazuje 5 řádků. Rows: n ukazuje, kolik jich je. Kliknutím na More zobrazíte všechny řádky, na Less opět 5. Kliknutím na záhlaví seřadíte.

Top queries from trace: nejnáročnější příkazy této minuty, seřazené podle Fetches. Najeďte ukazatelem na záhlaví a zobrazí se nápověda.

Sloupec Co zobrazuje
StmtID ID příkazu.
SQL Text Začátek textu SQL.
IP Address Adresa klienta.
Process Name Klientský program.
Time Celková doba všech spuštění tohoto příkazu.
Runs Kolikrát se v této minutě spustil.
Fetches, Reads, Writes, Marks Součty všech spuštění v této minutě.

Kliknutím na řádek zobrazíte celý text SQL, PLAN a PARAMETERS. Copy SQL zkopíruje text; Copy SQL with parameters se zobrazí, když příkaz má parametry.

Connections: každé připojení v této minutě, seřazené podle Fetches.

Sloupec Co zobrazuje
AttachID ID připojení.
Process Name, IP Address, Process ID Klientský program, jeho adresa a ID procesu.
Transactions Dokončené transakce připojení.
Act.Tran Aktivní transakce.
Prepared, Executed, Active Připravené, provedené a aktivní příkazy.
Fetched Rows Řádky načtené dokončenými příkazy v této minutě.
Time Doba provádění dokončených příkazů v této minutě.
Errors Chyby v této minutě.
Fetches, Reads, Marks, Writes Operace se stránkami dokončených příkazů v této minutě.

Zprávy, které se mohou zobrazit:

Zpráva Co znamená
Loading… Graf se načítá.
No data Žádná data pro tuto databázi v daném rozsahu.
Loading trace…, Loading connections… Tabulky pro vybranou minutu se načítají.
lwmmon files are missing for this minute. Agent nemá pro tuto minutu data o připojeních. Vyberte jinou minutu.

Když trace pro danou minutu neobsahuje žádné příkazy, tabulka trace se nezobrazí.

Čítače transakcí

Firebird uchovává čtyři čísla transakcí. Vždy rostou a zachovávají toto pořadí:

Transaction counters
  • Next-Oat je Next transakce minus Oldest active. Čára, která stále stoupá, znamená, že jedna transakce zůstává dlouho otevřená. Najděte ji v tabulce Connections nebo ve zprávě o stavu (dlouhé transakce).
  • OST − OIT je Oldest snapshot minus Oldest interesting. Roste, když garbage collection zaostává, například když je potřeba sweep.
  • Active Δ je počet nových transakcí za minutu.

5. Stránky databáze

Každá databáze má čtyři stránky: Database, Metrics, Clients Versions a Statistics. Otevřete je kliknutím na Details vedle databáze v tabulce Databases table na dashboardu. Odznaky gstat ve stejné tabulce otevírají přímo stránku Statistics.

Všechny čtyři stránky mají stejné záhlaví a stejný řádek pod ním:

  1. Logo a verze.
  2. ← Servers: návrat na stránku Servers.
  3. Název serveru, například SRV. Otevře dashboard tohoto serveru ve stejný den.
  4. Menu serveru: Logs, Configs, Errors, Conflicts, Perf Report, Jobs a Backups. Je to menu stránek serveru: jedním kliknutím otevřete logy nebo chyby tohoto serveru. Na stránce databáze není žádná položka zvýrazněna.
  5. Ikona ozubeného kola (Settings), Log out a seznam jazyků.
  6. Řádek databáze. Začíná štítkem DB a názvem databáze. Pak následují stránky databáze: Database, Metrics, Clients Versions, Statistics a Performance report. Otevřená stránka je podtržená. Řádek zůstává pod záhlavím při posouvání.
  7. Řádek s drobečkovou navigací: Servers › SRV › employee na stránce Database. Ostatní stránky přidávají svůj název, například Servers › SRV › employee › Metrics.

Performance report otevře stránku Perf Report serveru s touto databází vybranou v seznamu Database. Řádek databáze zůstává na této stránce, takže jedním kliknutím se vrátíte na Database nebo Metrics.

Změna databáze. Klikněte na název databáze v řádku. Otevře se seznam databází tohoto serveru s názvem, cestou a velikostí každé z nich. Aktuální databáze je označena. Kliknutím na jinou databázi otevřete stejnou stránku pro ni, ve stejný den a časový rozsah. Esc nebo kliknutí mimo seznam jej zavře. Šipky procházejí seznamem.

The list of databases under the database name
The list of databases under the database name
Text v seznamu Co znamená
Cannot load the list of databases Konzole nedostala odpověď. Zavřete seznam a otevřete jej znovu.
No databases for this day Agent neposlal seznam databází pro zvolený den. Zvolte jiný den.

Tyto stránky si můžete přidat do záložek. Adresa uchovává databázi, datum a časový rozsah.

Database

The Database page
The Database page

Co vidíte

  1. Záhlaví, řádek databáze a řádek s drobečkovou navigací.
  2. Řádek databáze: Database:, název databáze, odznaky stavu (pouze když databáze má stav), cesta, velikost a odznak Sweep. Například: employee /data/employee.fdb 58.1 GB Sweep off. Velikost je v MB pod 1024 MB a v GB nad tím. Najeďte ukazatelem na velikost a zobrazí se přesný počet bajtů.
  3. Druhý řádek: Page size, Dialect, Creation date, Owner a Security DB. Owner se zobrazuje pouze tehdy, když jej agent zná. Security DB se zobrazuje pouze tehdy, když databáze nepoužívá výchozí bezpečnostní databázi: self znamená, že databáze ověřuje přihlášení sama, sec: … znamená, že používá jinou bezpečnostní databázi.
  4. Časová lišta: časové pásmo dat serveru (viz Time and time zone), tlačítko data, From — To a seznam předvoleb: Last 1h (výchozí), Last 6h, Last 12h, Full day, Selected. Po kliknutí na graf se zde také zobrazí Selected minute: HH:MM.
  5. Čtyři grafy za minutu pro vybraný rozsah.

Velikost, odznaky stavu a odznak Sweep zobrazují nejnovější hodnoty do konce vybraného rozsahu. Dřívější den tedy zobrazuje hodnoty toho dne.

Odznaky stavu a Sweep

Znamenají totéž jako v tabulce Databases table na dashboardu.

Barva Odznaky
Červená Full shutdown
Jantarová Single-user shutdown, Multi-user shutdown, Shutdown (maintenance), nbackup lock
Modrá nbackup merge, Replica (read-only), Replica (read-write), Replica, Read only
  • Stav pochází ze záhlaví databáze nebo z MON$DATABASE, podle toho, který je novější. Najeďte ukazatelem na odznak a zobrazí se zdroj a čas: From the database header, 01:00 nebo From MON$DATABASE, 01:00.
  • Pokud jsou data o více než 15 minut starší než konec rozsahu, je odznak bledší a popisek končí (stale).
  • Sweep 20000: interval automatického sweepu ze záhlaví databáze, v transakcích. Sweep off (čárkovaný rámeček): interval sweepu je 0, takže automatický sweep je vypnutý. Odznak vyžaduje fbagent 2.91.0 nebo novější.

Grafy

Graf Řady
LWM activeAtt, activeReq, execTime Δ, fetches
Transactions Next-Oat, OST − OIT, Active Δ (stejné jako na dashboardu, viz Čítače transakcí)
Fetches, reads, writes, marks, rowsFetched fetches Δ, reads Δ, writes Δ, marks Δ, rowsFetched Δ: operace se stránkami za minutu
Requests: prepReq Δ, execReq Δ, activeReq, rowsFetched Δ prepared (Δ), prepared now, execReq Δ, activeReq, rowsFetched Δ

Δ znamená změnu oproti předchozí minutě. Mezera znamená, že čítač byl resetován, například po restartu Firebird, nebo že agent byl v této minutě aktualizován na nové čítače (fbagent 2.67.0 a novější počítají také otevřená připojení). Když agent hlásí, že záznam LWM databáze byl znovu vytvořen, minuta zobrazuje práci od té doby místo mezery.

prepared (Δ) je starý čítač prepReq (agenti před 2.67.0): příkazy připravené za minutu. prepared now pochází z novějších agentů: příkazy připravené v daném okamžiku. Den aktualizace agenta zobrazuje první řádek před aktualizací a druhý po ní.

Tipy:

  • Název serveru v záhlaví otevře dashboard se stejným datem a časovým rozsahem.
  • Změna data, rozsahu nebo předvolby vymaže vybranou minutu.

Top queries a connections

Kliknutím na graf vyberte minutu. Konzole vezme nejbližší minutu s daty a označí ji svislou čarou na všech čtyřech grafech. Pod grafy se objeví dvě tabulky.

Top queries and connections for the selected minute
Top queries and connections for the selected minute

Co vidíte

  1. Top queries from trace a počet jeho řádků (Rows: n). Jeden řádek na příkaz z trace v této minutě.
  2. Connections a počet jeho řádků. Jeden řádek na připojení (z dat LWM této minuty).

Obě tabulky fungují stejně:

  • Zobrazují prvních 5 řádků. More zobrazí všechny řádky, Less opět 5.
  • Jsou seřazeny podle Fetches, od největšího. Kliknutím na záhlaví sloupce seřadíte podle něj. První kliknutí na číselný sloupec seřadí největší hodnoty první. Druhé kliknutí pořadí obrátí. Seřazený sloupec je modrý.
  • Široké tabulky se posouvají doprava.

Sloupce Top queries from trace:

Sloupec Co zobrazuje
StmtID ID příkazu z trace.
SQL Text Začátek příkazu. Kliknutím na řádek jej otevřete.
IP Address Adresa klienta, například 192.168.0.10.
Process Name Klientský program.
Time Celková uplynulá doba všech takových dotazů v této minutě.
Runs Kolikrát se tento dotaz v této minutě spustil.
Fetches, Reads, Writes, Marks Součty pro všechna spuštění v této minutě.

Kliknutím na řádek dotazu jej otevřete. Druhým kliknutím jej zavřete. Otevřený je vždy pouze jeden řádek.

  • SQL: úplný text příkazu.
  • PLAN: plán, který Firebird použil. NATURAL znamená úplné prohledání tabulky.
  • PARAMETERS: typy a hodnoty parametrů.
  • Copy SQL zkopíruje příkaz. Copy SQL with parameters se zobrazí pouze tehdy, když příkaz má parametry. V demo režimu jsou tato tlačítka skryta.
An open Top queries row with the SQL, PLAN and PARAMETERS blocks
An open Top queries row with the SQL, PLAN and PARAMETERS blocks

Sloupce Connections:

Sloupec Co zobrazuje
AttachID ID připojení.
Process Name, IP Address, Process ID Klientský program, jeho adresa a ID procesu.
Transactions Dokončené transakce v tomto připojení.
Act.Tran Aktivní transakce.
Prepared Přípravy příkazů.
Executed Vykonané příkazy.
Active Aktivní příkazy.
Fetched Rows, Time, Errors, Fetches, Reads, Marks, Writes Hodnoty příkazů, které byly v této minutě v tomto připojení dokončeny.

Hodnota, kterou agent nezaznamenal, se zobrazí jako —. Například seřaďte podle Act.Tran, abyste našli připojení, která drží transakce otevřené.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Loading trace… / Loading connections… Konzole načítá tabulku.
No trace data for this minute. Trace nemá pro tuto databázi v této minutě žádné příkazy. Vyberte jinou minutu.
No connections data for this minute. Data LWM pro tuto minutu neobsahují žádná připojení.
lwmmon files are missing for this minute. Agent v dané době neshromažďoval data o připojeních.
Trace error: … / Connections error: … Data se nepodařilo načíst. Text uvádí důvod.

Metriky

Podrobné tabulky z jednoho snímku MON$ databáze.

  1. Vyberte datum a časový rozsah.
  2. Klikněte na tlačítko času snímku. Ve výchozím nastavení je vybrán nejnovější.
The Metrics page
The Metrics page

Co vidíte

  1. Záhlaví, řádek databáze a řádek s drobečkovou navigací (Servers › SRV › employee › Metrics).
  2. Časový pruh: tlačítko data, From — To a seznam předvoleb. Stránka načítá snímky dne, do kterého spadá konec rozsahu.
  3. Informační rámeček, pouze když stránka musí vysvětlit chybějící data (viz zprávy níže).
  4. Panel snímků: Snapshot: 20:00 (vybraný čas) a jedno tlačítko pro každý čas snímku. Vybrané tlačítko je modré. Tlačítko s oranžovým rámečkem označuje snímek, u kterého agent nemohl přečíst MON$. Najeďte na něj myší a zobrazí se zpráva agenta.
  5. Pět tabulek. Každý název tabulky zobrazuje počet řádků.
Tabulka Sloupce Co zobrazuje
Aggregated activity #, inserts, updates, deletes, total_dml, backouts, purges, expunges, total_versioning Operace se záznamy v celé databázi (MON$RECORD_STATS).
Total connections total_connections, total_transactions, tx/conn, total_statements, stmt/tx Připojení, transakce a příkazy v čase snímku.
Process memory Process, Connections, memory_used, memory_allocated, max_memory_used, max_memory_allocated Paměť na klientský program. Připojení jednoho programu se sčítají.
Top connections by memory Process, IP address, stejné čtyři sloupce paměti 5 připojení, která spotřebovávají nejvíce paměti.
Top connections by load Process, IP address, inserts, updates, deletes, total_dml, statement_count 5 připojení s nejvíce změnami a 5 připojení s nejvíce příkazy.
  • Kliknutím na záhlaví sloupce seřadíte. Seřazený sloupec zobrazuje ▼ nebo ▲. Číselné sloupce seřazují od největší hodnoty, Process a IP address seřazují od A do Z.
  • Paměť se zobrazuje v MB, například 139.3 Mb.
  • Prázdná buňka Process znamená, že připojení neuvedlo svůj program.

Proč databáze nemá data metrik

Agent čte MON$ každou hodinu, a to pouze u databází, které jsou v daném okamžiku aktivní (mají připojení): ve výchozím nastavení až 10 na server. Limit mění nastavení agenta firebird.database_metrics.max_active_databases (-1 znamená bez omezení). Databáze uvedené v conf/database_metrics_targets.json se čtou vždy jako první, pokud jsou aktivní. Bezpečnostní databáze se nečtou.

Na serveru s mnoha malými databázemi většina z nich nemá data metrik nebo má data jen pro některé hodiny. To je očekávané. Stránka pak zobrazí upozornění:

The Metrics page with no snapshots in the selected range
The Metrics page with no snapshots in the selected range

Zprávy, které se mohou zobrazit

Zpráva Co znamená
The agent does not collect MON$ statistics for this database. … Agent nemá pro tuto databázi data MON$ v žádný den. Viz limit výše.
The agent read this database at other times. Choose another date or a longer range. … Pro tuto databázi existují data MON$, ale ne ve vybraném rozsahu.
The agent could not read MON$ at 01:00: … Agent se pokusil, ale nemohl se připojit nebo mu vypršel čas. Text zobrazuje zprávu agenta, například record_stats: context deadline exceeded.
Select a snapshot time / No snapshots in the selected time range. Rozsah neobsahuje žádné snímky. Vyberte jiné datum nebo delší rozsah.
No data for the selected snapshot. Tabulka nemá pro tento snímek žádné řádky. Snímek s oranžovým rámečkem to zobrazuje ve svých tabulkách.
Failed to load metrics: … Data se nepodařilo načíst. Text uvádí důvod.

Verze klientů

Verze klientských knihoven Firebird, které se připojují k této databázi, a počet připojení pro každou z nich.

The Clients Versions page
The Clients Versions page

Co vidíte

  1. Záhlaví, řádek databáze a řádek s drobečkovou navigací (Servers › SRV › employee › Clients Versions).
  2. Check time: čas, kdy agent přečetl verze klientů, nebo —.
  3. Časové pásmo Check time (viz Čas a časové pásmo) a tlačítko data. Kalendář nabízí pouze dny s daty o verzích klientů. Ve výchozím nastavení se otevře nejnovější den.
  4. Tabulka Clients versions a počet jejích řádků.
Sloupec Co zobrazuje
# Číslo řádku.
Client version Řetězec verze, který klient uvedl, například WI-V5.0.1.1469 Firebird 5.0. Not detected. Old version? znamená, že klient neuvedl svou verzi. Obvykle jde o starou klientskou knihovnu. Řádek jako fbagent/2.93.0 počítá připojení samotného agenta.
Connection count Počet připojení s touto verzí.

Kliknutím na Connection count seřadíte: první kliknutí seřadí od největšího, druhé kliknutí od nejmenšího, třetí kliknutí vrátí původní pořadí.

Agent čte verze klientů jednou denně (ve výchozím nastavení v 11:00), a to pro stejné databáze jako u metrik (viz Proč databáze nemá data metrik).

Zprávy, které se mohou zobrazit

Zpráva Co znamená
The agent does not collect client versions for this database. … Agent pro tuto databázi nikdy nečetl verze klientů.
The agent could not read client versions at 11:00: … Agent se pokusil a neuspěl. Text uvádí důvod. skipped znamená Firebird 2.5, který nemá MON$CLIENT_VERSION.
No data for the selected date. Vybraný den nemá žádné řádky. Vyberte jiné datum.
No ClientVersions files for this database. Zobrazuje se v kalendáři: nejsou k dispozici žádné dny k výběru.
Failed to load client versions: … / Failed to load dates: … Data se nepodařilo načíst. Text uvádí důvod.

6. Statistiky: zprávy gstat a trendy

Stránka Statistics analyzuje soubory gstat, které agent pro databázi shromažďuje. Agent spouští gstat jednou denně (ve výchozím nastavení ve 02:00). Na serveru s mnoha databázemi agent také omezuje počet databází na jedno spuštění, takže některé databáze nemají žádné soubory gstat.

Stránka má nahoře dvě tlačítka: Report a Trends. Řádek s drobečkovou navigací odpovídá otevřené kartě: Servers › SRV › employee › Statistics › Report nebo … › Statistics › Trends. Adresa uchovává vybraný soubor, kartu a nastavení trendů, takže si můžete zprávu uložit do záložek.

Štítky gstat v tabulce Databases na dashboardu otevírají tuto stránku: štítky kritických stavů a varování otevírají kartu Analysis and Recommendations a +25% otevírá Trends s kartou Forecasts.

Report

The Statistics report: Summary tab
The Statistics report: Summary tab

Co vidíte

  1. Záhlaví, řádek databáze a řádek s drobečkovou navigací.
  2. Tlačítka Report a Trends. Otevřené tlačítko je oranžové.
  3. Pruh zprávy:
    • Select snapshot: soubory gstat, nejnovější první. Každá položka zobrazuje datum a název souboru.
    • Štítky: critical - {n} (červený), warnings - {n} (jantarový), notes - {n} (modrý). Štítek s hodnotou 0 je skrytý.
    • Download JSON: naměřené hodnoty.
    • Download Excel: úplná analýza jako sešit .xlsx v aktuálním jazyce.
  4. Rámeček s poznámkami, pouze když měl analyzátor k souboru poznámky.
  5. Zpráva s vlastními kartami:
    • Summary: velikost dat, indexů a BLOBů, největší tabulky, indexy v hloubce 3, hlavní zjištění a nejnáročnější dotazy, pokud jsou známy.
    • Tables a Indexes: jeden řádek na tabulku nebo index.
    • Analysis and Recommendations: co je špatně a co dělat.
    • Queries a Links: pouze když má agent zprávy o výkonu blízko času snímku (viz karta Queries).

Karta Tables

The Tables tab
The Tables tab

Zadáním do Filter by name zobrazíte pouze odpovídající tabulky. Kliknutím na záhlaví sloupce seřadíte.

Sloupec Co zobrazuje
Table Název tabulky, její ID, odkaz queries (n), když tabulku čtou dotazy, a Details s dalšími hodnotami.
Size: Data, Indexes, BLOB, Total Velikost jednotlivých částí. Pod ní: podíl na databázi, počet indexů, stránky BLOBů.
Records Počet záznamů a průměrná délka záznamu (avg).
Versions / MaxV Počet starých verzí a nejvyšší počet verzí jednoho záznamu.

| BLOB | Počet BLOBů a jejich stránek. | | Other | Průměrné zaplnění datových stránek, počet indexů a největší hloubka indexu. |

Karta Indexes má stejný filtr. Její sloupce: Index (název, id, queries (n)), Table, Size (s podílem na datech tabulky), Structure (hloubka, stránky, nízké zaplnění) a Key (uzly, odlišné hodnoty, duplicity, průměrná délka klíče). Řádky s hloubkou 4 jsou žluté. Řádky s hloubkou 5 nebo více jsou červené.

Karta Analysis and Recommendations

The Analysis and Recommendations tab
The Analysis and Recommendations tab
  • Jedna karta na kategorii, například High BLOB Usage nebo Index Inefficiency.
  • Barevný rámeček pro každý problém: Issue:, popis a Number of issues:. Pod ním Affected objects: vypisuje tabulky a indexy. Každý název je odkaz.
  • Rámeček s doporučením: Recommendation:, Rationale:, Impact: a Action:. Dlouhý seznam objektů zobrazí 3 objekty a More (n).

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No gstat files found Agent nemá pro tuto databázi žádný soubor gstat. Viz omezení v úvodu.
Generating report… Konzole analyzuje soubor. Počkejte.
Failed to load report Soubor nebylo možné přečíst nebo analyzovat.
This snapshot has no database header, so header-based checks were skipped. Soubor gstat nemá část s hlavičkou. Kontroly, které ji potřebují, chybí.
The analyzer had remarks about this file: Následuje seznam připomínek analyzátoru.

Karta Queries

Karta Queries spojuje statistiky gstat s dotazy, které se spustily na serveru. Ukazuje, které příkazy čtou které tabulky a indexy, takže můžete najít dotaz stojící za problémovou tabulkou.

The Queries tab
The Queries tab
Sloupec Co zobrazuje
SQL / process Příkaz, klientský program a počet textových variant. SQL otevře celý text.
Time Celkový čas v ms a jeho podíl na celkovém čase.
Count / avg Kolikrát se příkaz spustil a průměrný čas.
Fetches Celkové počty načtení a načtení na řádek. computed in cache znamená mnoho načtení, ale téměř žádné čtení stránek.
Reads, Writes, Marks Součty čtení, zápisů a značek stránek.
  • Data pocházejí z výkonnostních reportů agenta (stejná data jako Perf Report).
  • Konzole používá okna reportů, která končí nejvýše 23 hodin od doby snímku gstat. Starší ani novější okna se nepoužívají.
  • Prázdné, prošlé nebo poškozené soubory reportů se přeskakují. Pokud nezůstane žádné použitelné okno, karta Queries se nezobrazí.
  • Výkonnostní report pokrývá celý server. Na serveru s několika databázemi může karta zobrazit příkazy, které se spustily proti jiným databázím.
  • Filter by name zobrazí pouze odpovídající příkazy.
  • Links vypisuje tabulky a indexy s počtem zásahů dotazů. Na kartách Tables a Indexes otevře odkaz queries (n) odpovídající dotazy.
  • Soubor Excel pak obsahuje také listy Queries, Processes and addresses a Addresses.

Karta Trends porovnává nejnovější snímky a ukazuje, jak se tabulky a indexy mění v čase. Nepoužívá snímek vybraný na kartě Report. Karta se načte při prvním otevření.

The Trends tab
The Trends tab

Co uvidíte

  1. Hlavičku, řádek databáze a řádek s drobečkovou navigací (končí na Trends).
  2. Panel trendů:
    • Compare last: kolik snímků porovnat. Seznam nabízí 5 snapshots, 10 snapshots, 20 snapshots a 30 snapshots, ale jen do počtu souborů. Při méně než 30 souborech seznam nabízí i všechny z nich. Výchozí hodnota je 10, nebo největší volba, když je souborů méně.
    • Report changes over: nejmenší změna, která se má hlásit: ≥ 10% (výchozí), ≥ 2% nebo ≥ 0.5%. Pokud klidná databáze nic neukazuje, zvolte nižší hodnotu.
    • Download JSON a Download Excel, stejně jako na kartě Report.
  3. Report trendů: Gstat Trend Report, databáze, počet snímků, jejich data a čas vytvoření reportu. Jeho karty:
    • Summary: Largest size changes (Object, Property, Change, Change %) a Snapshots (Label, Execution time, Page size, Total data pages, Total records).
    • Tables a Indexes: hodnoty každého objektu v každém snímku.
    • Changes: každá změna nad zvoleným limitem, s první a poslední hodnotou a úrovní.
    • Forecasts: Growth Forecasts (reaching +25%): aktuální velikost, přírůstek za den a datum, kdy objekt vzroste o 25 %. Odhad potřebuje alespoň tři snímky.
    • Charts: velikosti tabulek, velikosti indexů, celkové velikosti, počty verzí a transakce a připojení.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No gstat files found Agent nemá pro tuto databázi žádný soubor gstat.
Comparing snapshots… Konzole sestavuje report trendů.
A trend report needs at least two snapshots Existuje pouze jeden soubor gstat. Počkejte na další denní běh.
Failed to build the trend report Soubory nebylo možné porovnat.
Warning: page size or ODS version changed between snapshots - trends may not be directly comparable Zobrazuje se v reportu. Velikost stránky nebo verze ODS není ve všech snímcích stejná, například po obnově.
No growth forecasts. Zobrazuje se v Forecasts: report nemá pro žádnou tabulku ani index žádnou předpověď.

7. Nástroje serveru

Tyto stránky se otevírají z nabídky v hlavičce serveru: Logs, Configs, Errors, Conflicts a Perf Report. Každá stránka má vlevo v hlavičce ← Servers a pod hlavičkou řádek s drobečkovou navigací, například Servers › SRV › Logs. Všechny časy jsou v časovém pásmu serveru (viz Time and time zone).

Logs, Errors a Conflicts filtrují řádky stejným způsobem:

  • Include: a Exclude: přijímají jednu nebo více částí slov oddělených čárkami nebo středníky. Na velikosti písmen nezáleží.
  • Include ponechá řádek, který obsahuje kteroukoli z částí. Exclude skryje řádek, který obsahuje kteroukoli z částí.

Logs

Logy Firebird serveru se dvěma kartami: Firebird.log a Replication.log. Agent odesílá záznamy logu den po dni.

The Logs page
The Logs page

Co uvidíte

  1. Řádek filtru: Include:, Exclude: a Apply (nebo Enter v poli filtru).
  2. Časový panel: odznak časového pásma, tlačítko data, počáteční a koncový čas a seznam předvoleb.
  3. Karty Firebird.log a Replication.log.
  4. Panel stránkování: Prev, čísla stránek, Next, pole Page a Total records: N. Stejný panel je i pod tabulkou.
  5. Tabulka záznamů logu.

Filtry. Filtry prohlížejí zprávu, zdroj a databázi každého záznamu. Chcete-li je použít, klikněte na Apply nebo stiskněte Enter v poli filtru. Na kartě Firebird.log je Exclude ve výchozím nastavení INET: skrývá síťové zprávy, jako je INET/inet_error. Na kartě Replication.log je Exclude prázdné. Při přepnutí karty se Include vymaže a Exclude znovu získá výchozí hodnotu dané karty.

Datum a čas.

  • Kalendář obsahuje dny obou logů. Stránka se otevírá na nejnovějším dni. Když zvolíte jiný den, tabulka se znovu načte.
  • Seznam předvoleb nastavuje rozsah dne:
    • Full day (výchozí): 00:00–23:59.
    • Last 1h: hodina, která končí nejnovějším záznamem dne.
    • Last 6h: 18:00–23:59.
    • Last 12h: 12:00–23:59.
    • Selected: rozsah, který nastavíte ručně.
  • Předvolba načte tabulku okamžitě. Poté, co ručně změníte počáteční nebo koncový čas, klikněte na Apply.

Tabulka

Sloupec Co zobrazuje
# Pořadové číslo záznamu ve výsledku.
Date / Time Datum a čas záznamu.
Source Název počítače v záznamu.
Database Databáze záznamu, nebo —, když záznam žádnou neuvádí.
Status Pouze na Replication.log: stav záznamu. Kliknutím na záhlaví seřadíte podle něj; dalším kliknutím pořadí obrátíte.
Message Text záznamu.
  • Řádek je červený, když jeho zpráva obsahuje bugcheck, internal consistency check, abnormal termination nebo operating system. Tyto záznamy čtěte nejdříve.
  • Tabulka má 100 záznamů na stránku. Otevírá se na poslední stránce s nejnovějšími záznamy. Chcete-li přejít na stránku, zadejte její číslo do pole Page a stiskněte Enter. Seřazená tabulka se otevírá na stránce 1.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No entries for the selected date and time range. Žádný záznam neodpovídá dni, rozsahu a filtrům. Zvolte Full day nebo vymažte filtry.
firebird.log has no entries yet. The server has no such log, or it is empty. Agent neodeslal žádný den tohoto logu. Stejná zpráva uvádí replication.log na druhé kartě. Server bez replikace nemá log replikace.
No dates in log Kalendář nemá žádné dny: agent dosud neodeslal žádný log.
Failed to load dates: … / Failed to load logs: … Konzole nemohla přečíst data. Text za dvojtečkou uvádí důvod.

Configs

Uložené kopie souborů databases.conf, firebird.conf a replication.conf. Agent zkopíruje soubor pokaždé, když se změní. V každém seznamu zvolte kopii, abyste viděli nastavení v různých časech.

The Configs page
The Configs page

Co uvidíte

  1. Reload vpravo nahoře. Znovu načte nejnovější kopie souborů. Agent zkopíruje změněný soubor do minuty, takže po ruční úpravě na serveru počkejte minutu a klikněte na Reload.
  2. Tři panely: databases.conf, firebird.conf a replication.conf. Každý panel má seznam kopií a pod ním text souboru.
  3. Tlačítko Edit na panelu databases.conf (ne v demo režimu, takže na obrázku není).
  4. Pod panelem databases.conf: seznam problémů ve zvolené kopii. Zobrazuje se pouze tehdy, když kopie má problémy.
  • Každá položka seznamu je název souboru a čas kopie, například databases.conf (2026-06-26 13:22). Nejnovější kopie je první.
  • Jedna položka je jedna verze souboru. Agent 2.98.0 a novější zapisuje kopii každého souboru při každém startu a aktualizaci. Stejné kopie, které následují po sobě, se zobrazují jako jedna položka s časem první z nich: časem, kdy se obsah změnil. Seznam čte nejnovějších 500 kopií souboru.
  • V okně na ploše tři panely vyplňují okno až ke spodnímu okraji a

Každý panel se posouvá uvnitř. Seznam problémů zabírá nejvýše čtvrtinu výšky okna. V úzkém okně jsou panely v jednom sloupci.

Problémy v databases.conf. Konzole kontroluje syntaxi tak, jak soubor čte Firebird. Také kontroluje každý parametr v bloku pro konkrétní databázi proti tomu, co daná verze Firebird povoluje pro databázi. Každý problém je jeden řádek: Line 12: <message>. Řádek s chybou je červený, řádek s upozorněním je jantarový. Když se složené závorky { } neshodují, má text souboru červené pozadí.

Konzole čte verzi Firebird z dat agenta. Když verzi nenajde, kontroluje proti všem verzím a upozorní, že verze je neznámá. Název parametru s překlepem o jedno nebo dvě písmena dostane nápovědu, například unknown parameter "DefaultDBCachPages" — did you mean "DefaultDbCachePages"?.

Tlačítko Edit otevře editor databases.conf. Ostatní dva panely zůstávají jen pro čtení. Tlačítko se zobrazí jen tehdy, když platí všechny tyto podmínky:

  • Demo režim je vypnutý.
  • Konzole může otevřít soubor tohoto serveru:
    • Lokální režim (konzole běží na stroji s agentem): agent odpovídá na svém Local API.
    • Vzdálený režim: správce nastavil doručování konfigurace (goafts_push_enabled a klíče goafts_admin_*), goafts odpovídá a existuje soubor, ze kterého se dá vyjít. To je soubor dříve odeslaný na tento server, nebo alespoň jedna kopie databases.conf od agenta.
  • Soubor smíte uložit:
    • Lokální režim: režim jednoho uživatele, správce nebo účet s právem May push configuration to agents.
    • Vzdálený režim: účet s právem May push configuration to agents (viz Users). Správce toto právo potřebuje také.

Pokud u některého serveru ve vzdáleném režimu chybí tlačítko Edit, zkontrolujte tři věci: agent ještě neposlal žádnou kopii databases.conf (seznam uvádí No files), váš účet nemá právo push, nebo goafts neodpovídá.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No files Agent neposlal žádnou kopii tohoto souboru. Seznam je zakázán.
Error: … Konzole nemohla kopie přečíst. Text uvádí důvod.
"}" without an opened block a další syntaktické zprávy Firebird nemůže soubor na tomto místě přečíst. Opravte řádek.
parameter “…” cannot be set per database (Firebird …) Tento parametr funguje jen v firebird.conf. Firebird ho v bloku ignoruje.
alias “…” is also defined on line … Stejný alias je v souboru dvakrát.
path … has more than one parameter block: … Firebird použije jen jeden z bloků.
include is not checked: … (upozornění) Konzole vložené soubory neotevírá.
Firebird version is unknown — parameters were checked against all versions (upozornění) Agent neposlal verzi Firebird.
the file contains binary data Soubor není textový soubor.

Editor databases.conf

Editor zobrazuje databases.conf jako seznam cest k databázím. Každá cesta má své aliasy a nejvýše jeden blok parametrů. Ve Firebird 2.5 je soubor aliases.conf: stránka ho tak nazývá a zobrazuje ho jen v zobrazení Text (viz Firebird 2.5: aliases.conf níže).

The databases.conf editor in demo mode
The databases.conf editor in demo mode

Co vidíte

  1. Hlavičkový řádek:
    • ← Configs se vrátí na stránku Configs. Při neuložených změnách se nejprve zeptá: „Leave the page? Unsaved changes are lost.“
    • Název databases.conf a řádek zdroje: File: <path> v lokálním režimu, Delivered through the control center ve vzdáleném režimu. Pak verze Firebird a ve vzdáleném režimu Copy of the server file from <time> nebo výsledek Last delivery.
    • Unsaved changes (jantarová) se objeví po první změně.
    • Vpravo: tlačítko problémů (No problems, nebo Problems: n: červené s chybami, jantarové jen s upozorněními), Form a Text, Reload, Check a Save (ve vzdáleném režimu pojmenované Send).
  2. Stavový řádek pro výsledky Check a Save a řádek s upozorněním, když se nějaké týká.
  3. Vlevo: Add database nahoře, pak Find alias or path, seznam cest k databázím s jejich aliasy a Included files (řádky include souboru).
  4. Vpravo: karty vybrané cesty.

Seznam cest (vlevo). Find alias or path filtruje seznam. Červená tečka ● označuje cestu s chybami. Odznaky označují alias, který obsahuje blok parametrů (params), blok, který Firebird ignoruje (ignored), a opakovaný alias (duplicate).

Add database. Tlačítko je nahoře v seznamu cest. V zobrazení Text je stejné tlačítko nad textem, vlevo. Obě otevírají dialog Add database:

  • Zadejte Alias a Database path. Obě pole jsou povinná: Add zůstává zakázané, dokud je jedno z nich prázdné. V lokálním režimu příklad v poli cesty odpovídá OS cesty k souboru (C:\db\name.fdb nebo /db/name.fdb); jinak je to /db/name.fdb.
  • Add (nebo Enter) přidá řádek do textu na stránce. Cancel (nebo Esc) zavře dialog.
  • Když konzole záznam odmítne, dialog zůstane otevřený s vašimi hodnotami a ukáže proč: alias už existuje, cesta už je v souboru, alias nebo cesta obsahuje znaky, které soubor nemůže obsahovat, nebo Fix the text first: it has structural errors. (opravte text v zobrazení Text a zkuste to znovu).
  • Po Add zobrazení Form vybere novou cestu a zobrazení Text ukáže nový řádek. Stránka zobrazí Unsaved changes: soubor zapíše jen Save.
  • Tlačítka jsou zakázána v demo režimu, během běžícího požadavku, když editor nemůže soubor otevřít a když ho nesmíte uložit.

Karty (vpravo).

  • Database path: cesta. Remove path odstraní cestu a všechny její aliasy, po dotazu.

  • Upozornění, když má cesta dva bloky parametrů: Firebird použije jen jeden z nich. Merge into “<alias>” je spojí; Delete the block of “<alias>” jeden odstraní.

  • Aliases: všechny aliasy cesty.

    Sloupec Co zobrazuje
    Params Který alias obsahuje blok parametrů. Vyberte jiný alias, chcete-li blok přesunout tam.
    Alias Název aliasu, jeho řádek v souboru a jeho odznaky.
    Remove Odstraní alias, po dotazu.

    Zadejte název do pole new alias a klikněte na + Alias pro přidání.

  • Parameters (block of “<alias>”): parametry bloku.

    Sloupec Co zobrazuje
    Parameter Název parametru.
    Value Hodnota v bloku.
    firebird.conf Hodnota serveru z firebird.conf, když je známá.
    Remove Odstraní parametr.

    Chcete-li nějaký přidat, vyberte název v seznamu Parameter… (obsahuje jen parametry, které tato verze Firebird povoluje pro databázi), zadejte Value a klikněte na + Parameter. Prázdná hodnota znamená, že platí hodnota serveru. DatabaseAccess v seznamu není: Firebird ho uvnitř bloku ignoruje. Soubor, který ho nastavuje v bloku, neprojde Check; nastavte ho v firebird.conf.

  • Ignored block of “<alias>”: blok, který Firebird nepoužívá.

Form a Text. Form a Text přepínají mezi tímto zobrazením a surovým souborem. Každá změna ve formuláři mění text a komentáře a konce řádků zůstávají. Když formulář nemůže soubor přečíst, opravte ho v zobrazení Text.

Firebird 2.5: aliases.conf. Firebird 2.5 uchovává své aliasy v aliases.conf: jeden řádek alias = path pro každý, bez bloků parametrů. Pro tuto verzi název stránky uvádí aliases.conf, editor otevře zobrazení Text a Form a Text se nezobrazují. Add database funguje i tam. Když konzole nezná verzi Firebird, zobrazení Form zůstává dostupné.

Reload znovu přečte soubor ze serveru. Máte-li neuložené změny, editor se nejprve zeptá. Když se vrátíte na kartu nebo se v prohlížeči vrátíte na stránku a soubor se na serveru změnil, editor ho sám znovu přečte (jen když nemáte neuložené změny). V okně na ploše vyplňují seznam, formulář a text okno až k dolnímu okraji a posouvají se uvnitř.

Check a Save.

  • Opakovaný alias a druhý blok parametrů na jedné cestě jsou chyby. Konzole je najde dřív, než soubor odejde agentovi, takže ani starší agent takový soubor nemůže uložit.

  • Check ověří soubor a nic nezapíše. Save je zakázané, dokud má soubor chyby (tooltip Fix the errors first), a když nesmíte ukládat (tooltip You have no right to change this file).

  • Lokální režim: editor otevře živý soubor. Save ho odešle agentovi. Agent ho znovu ověří, ponechá zálohu vedle souboru a uložení odmítne, pokud se soubor mezitím změnil. Editor pak ponechá váš text a nabídne Reload. To vyžaduje fbagent 2.77 nebo novější. fbagent 2.83 nebo novější uchovává jednu zálohu na editační relaci, ne jednu na každé Save, a Save, který nic nemění, nic nezapíše.

  • Vzdálený režim: editor otevře kopii, kterou má goafts. Před prvním uložením otevře nejnovější kopii od agenta:

    • fbagent 2.94.0 nebo novější posílá soubor bajt po bajtu, s komentáři, prázdnými řádky a konci řádků. Hlavička zobrazuje Copy of the server file from <time>.
    • Starší agent posílá soubor bez komentářů a prázdných řádků. Pak se Send nejprve zeptá, zda pokračovat: uložení je ze souboru na serveru odstraní.

    Send uloží soubor na goafts. Agent ho převezme při své příští synchronizaci. Změnu odmítne, pokud se jeho soubor změnil poté, co ho editor otevřel. Jinak soubor použije se zálohou a podá hlášení. Dokud změna čeká na agenta, je stránka jen pro čtení. Hlavička zobrazí výsledek při příštím otevření editoru.

  • Každé uložení se zapíše do auditního logu.

  • V demo režimu je editor jen pro čtení: všechna tlačítka jsou zakázána.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No problems found Check nic nenašel.
No errors. See the warnings. Můžete uložit. Nejprve si přečtěte upozornění.
The file has errors. / Not saved: the file has errors. Opravte chyby, které ukazuje seznam problémů.
Saved. The agent keeps one backup next to the file: the file as it was before this editing session. Lokální režim: agent zapsal soubor.
Sent. The agent applies it within about a minute; the result shows here after its report. Vzdálený režim: goafts drží soubor pro agenta.
The file changed on the server. Your text stays here: copy it, then reload. Někdo změnil soubor poté, co jste ho otevřeli. Editor přepne do zobrazení Text. Zkopírujte svůj text, klikněte na Reload a pak změnu udělejte znovu.
The file changed on the server. The page shows the new version. Neměli jste neuložené změny, takže editor přečetl nový soubor.
The form cannot read this file. Fix it in the Text view. Soubor má syntaktickou chybu, kterou formulář nemůže zobrazit.
Change refused: … / Agent error: … Agent soubor nepřijal. Text uvádí důvod.
The agent has not applied the last change yet. Reload the page in a few minutes. Vzdálený režim: odeslaná změna čeká na agenta. Stránka je jen pro čtení, dokud agent nepodá hlášení.
The agent refused the last change: the file on the server changed after the editor opened it. The page shows the current file. Make the change again. Vzdálený režim: někdo mezitím změnil soubor na serveru. Udělejte změnu znovu na souboru, který stránka nyní zobrazuje.
This file is from a snapshot without comments and empty lines. Saving removes them from the file on the server. Continue? Vzdálený režim s agentem 2.93.0 nebo starším. Kliknutím na Cancel komentáře zachováte; místo toho upravte soubor na serveru.

| Úpravy nejsou dostupné: … | Konzole nemůže otevřít soubor tohoto serveru (viz pravidla tlačítka Upravit v části Konfigurace). | | Agent ještě neposlal kopii souboru. Kopie dorazí po restartu agenta. | Vzdálený režim: goafts nemá pro tento server žádný soubor a konzole nemá od agenta žádnou kopii. Restartujte agenta, počkejte na jeho kopii a poté editor znovu otevřete. | | Nejprve opravte text: obsahuje strukturální chyby. | V dialogu Přidat databázi: text obsahuje chybu, kterou editor nedokáže obejít. Zavřete dialog a opravte text v zobrazení Text. | | Demo režim: editor je jen pro čtení. | Chcete-li upravovat, vypněte demo režim. |

Chyby

Chyby Firebird z trace: čas, ID připojení, text chyby a databáze. Stejná chyba, která se opakuje, je zobrazena jako jeden řádek s počtem.

The Errors page
The Errors page

Co vidíte

  1. Řádek filtrů: Zahrnout:, Vyloučit: a Použít. Můžete také stisknout Enter v poli filtru.
  2. Časová lišta: odznak časového pásma, tlačítko data, počáteční a koncový čas a seznam předvoleb.
  3. Nadpis Chyby s počtem řádků a Exportovat CSV napravo od něj (ne v demo režimu, proto na obrázku není).
  4. Stránkovací lišta: Předchozí, čísla stránek, Další, pole Stránka a řádek s celkovým počtem. Stejná lišta je také pod tabulkou.
  5. Tabulka chyb.

Časový rozsah. Výchozí je Poslední 1 h: hodina, která končí u poslední chyby dne. Posledních 6 h je 18:00–23:59, Posledních 12 h je 12:00–23:59 a Celý den je 00:00–23:59. Odkaz Všechny chyby → ve zprávě o stavu otevře den jako Celý den.

Filtry. Filtry prohledávají text chyby, ID připojení, čas, databázi, aplikace, adresy a funkci Firebird.

Tabulka

Sloupec Co zobrazuje
# Číslo řádku.
tstmp Čas chyby (HH:MM), s datem pod ním menším písmem.
attID ID připojení.
count U řádku s počtem: ×N, kolik chyb řádek obsahuje. Sloupec se zobrazuje pouze tehdy, když některé řádky mají počet.
db Databáze. Sloupec se zobrazuje pouze tehdy, když chyba nějakou uvádí.
errTxt Text chyby, s řádkem klienta pod ním.
  • Řádek s počtem obsahuje jeden druh chyby, v jedné minutě, na jedné databázi. Najeďte na ×N a zobrazí se první a poslední čas a počet připojení, například First and last error: 13:05:01-13:05:58; Attachments: 3.
  • Řádek klienta zobrazuje klienta, který chybu obdržel: aplikaci, adresu klienta a funkci Firebird. Řádek s počtem uvádí různé aplikace a adresy všech svých chyb (pět, poté „…“, pokud je jich více). Kliknutím na aplikaci nebo adresu zobrazíte pouze její chyby (ne v demo režimu). Řádek je prázdný pro starší data a pro klienty, kteří neposílají název aplikace (mnoho ovladačů JDBC a .NET).
  • Tabulka má 50 řádků na stránku. Otevírá se na poslední stránce s nejnovějšími chybami.
  • Řádek s celkovým počtem je Total records for 00:00 — 23:59: 394. Pokud mají řádky počty, přičte se počet chyb: …: 394, errors: 898.

Exportovat CSV stáhne všechny řádky tabulky, na všech stránkách, se stejnými filtry a časovým rozsahem.

  • Název souboru obsahuje den a rozsah, například errors_2026-11-03_1300-1400.csv.
  • Soubor je UTF-8 s BOM, takže Excel zobrazí všechna písmena správně.
  • Oddělovačem je čárka v angličtině a středník v ostatních jazycích, takže Excel otevře soubor ve sloupcích.
  • Řádek s počtem zůstává jedním řádkem. Sloupce jsou #, date, time, last (čas poslední chyby), attID, count, atts (počet připojení), db, app, host, fn a errTxt. last, count a atts jsou přítomny pouze tehdy, když některé řádky mají počet; db pouze tehdy, když chyba uvádí databázi. Několik aplikací nebo adres je spojeno pomocí ; .
  • Textová buňka, která začíná znakem =, +, - nebo @, dostane na začátek ', takže ji Excel nespustí jako vzorec.
  • Tlačítko je v demo režimu skryté, protože soubor obsahuje skutečné hodnoty. Je také skryté, když je tabulka prázdná.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No entries for the selected date and time range. Žádná chyba neodpovídá dni, rozsahu a filtrům. Zvolte Celý den nebo vymažte filtry.
No error files found Kalendář nemá žádné dny: agent neposlal žádné chyby z trace.
Failed to load dates: … / Failed to load errors: … Konzole nemohla načíst data. Text za dvojtečkou uvádí důvod.

Konflikty

Zámkové konflikty a uváznutí z trace, po minutách. Každá skupina je jedna transakce, která způsobila konflikty.

The Conflicts page
The Conflicts page

Co vidíte

  1. Řádek filtrů: Zahrnout:, Vyloučit: a Použít (nebo Enter).
  2. Odznak časového pásma a tlačítko data.
  3. Vlevo: seznam minut s konflikty, nejnovější první. Minuta zeleně má také úspěšné příkazy. Vybraná minuta je zvýrazněna.
  4. Vpravo: nadpis Konflikty s počtem zobrazených skupin (po filtru) a skupiny.

Jak číst minutu:

  1. Vyberte minutu v seznamu vlevo. Je vybrána ta nejnovější.
  2. Každá skupina začíná #n, Transaction ID: <id> a Error Time.
  3. Porovnejte dva sloupce:
    • Conflict errors: Attachment ID, Process, Error text (kódy a zprávy chyb Firebird, například deadlock a update conflicts with concurrent update), a Failed statement, pokud jej trace obsahuje.
    • Successful statements: příkazy souběžné transakce, které uspěly, s jejich Timestamp, Attachment ID, Transaction ID a Process.
  4. Každý příkaz zobrazuje své SQL, Parameters, Statistics a Tables.
  • Filtry pracují s textem každé skupiny v prohlížeči. Počet v nadpisu ukazuje, kolik skupin zbývá.
  • Copy SQL a Copy SQL with parameters (pokud má příkaz parametry) jsou vedle SQL. Přenášejí SQL do vašich vlastních nástrojů. Jsou skryté v demo režimu.
  • Adresa stránky uchovává datum a minutu, takže můžete odeslat odkaz.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No conflict report files found. Agent neposlal žádná data o konfliktech.
No conflict data for the selected minute. Minuta nemá žádné skupiny.
No conflict errors / No successful statements Jeden sloupec skupiny je prázdný.
Failed to load conflicts: …, Failed to load dates: …, Failed to load minutes: … Konzole nemohla načíst data. Text uvádí důvod.

Perf Report

Výkonnostní zpráva agenta pro časové okno: nejnáročnější SQL příkazy, plány, procedury, triggery, databáze, procesy a klientské adresy. Agent sestavuje zprávu pro každé naplánované okno. Může také sestavit zprávu pro libovolný rozsah na vyžádání (viz Zprávy na vyžádání).

The Perf Report page
The Perf Report page

Co vidíte

  1. Odznak časového pásma, tlačítko data, seznam Reports on request (pouze když agent takové zprávy má) a tlačítko Build report….
  2. Vlevo: seznam časů zpráv dne, nejnovější první.
  3. Vpravo: nadpis Perf Report a souhrn okna.
  4. Řádek nástrojů: vyhledávací pole Search in SQL, plan, process, address, Compare with, Database a Download JSON.
  5. Tlačítka žebříčků, například Longest run, Total time, Frequency, Fetches, Reads, Writes, Plans: time a Plans: frequency. Vybrané je modré.
  6. Tabulka vybraného žebříčku, například TOP SQL BY DURATION.
  7. Tabulky DATABASES, PROCESSES a ADDRESSES.

Souhrn: Window start, Window end, Statements, Unique statements, Attach a Detach (připojení otevřená a uzavřená v okně), Total duration (ms), Total fetches, Total reads, Total writes, Total marks, Plans, Failed statements, Databases, Grouped by (například plan), Source files a Minutes with data (například 330 / 330). Hodnota nula se nezobrazuje.

Zpráva, kterou agent sestavil před zpracováním všech souborů trace daného okna, začíná řádkem „Incomplete report: some trace files of this window were not processed in time. The numbers cover a part of the window.“

Žebříčky. Každé tlačítko otevře jeden žebříček. Stránka zobrazuje pouze žebříčky, které mají řádky.

Tlačítko Tabulka Seřazeno podle
Longest run Top SQL by duration Doba běhu jednoho spuštění.
Total time Top SQL by total time Součet dob běhu.
Frequency Top SQL by number of runs Kolikrát se příkaz spustil.
Fetches, Reads, Writes Top SQL by fetches, by reads, by writes Součet metriky.
Plans: time, Plans: frequency Top plans by total time, by number of runs Totéž pro jeden plán.
Tags: time, Tags: frequency Top tags by total time, by number of runs Totéž pro jeden tag.
Procedures: time, Procedures: frequency Top procedures by … Totéž pro jednu uloženou proceduru.
Triggers: time, Triggers: frequency Top triggers by … Totéž pro jeden trigger.

Každá tabulka zobrazuje 5 řádků. More zobrazí všechny řádky, Less znovu 5. Kliknutím na záhlaví sloupce seřadíte. Příkaz s neúspěšnými běhy má značku failed nebo failed: N před svým SQL.

  • Top SQL by duration má sloupce Rank, Duration (ms), Records fetched a SQL.
  • Ostatní žebříčky mají Rank, Count, součty Duration (ms), Fetches, Reads, Writes a Marks, podíl na celkovém součtu okna (<metric> %), průměr a největší hodnotu pro jedno spuštění (<metric> avg/run, <metric> max/run) a SQL. Žebříček tagů, procedur nebo triggerů má název v prvním sloupci. Žebříček procedur nebo triggerů nemá sloupec SQL.

DATABASES, PROCESSES a ADDRESSES: jeden řádek na databázi, klientský program nebo klientskou adresu, seřazeno podle doby trvání.

Sloupec Co zobrazuje
Database / Process / Address Databáze, klientský program nebo klientská adresa.
Count Příkazy.
ATT, DET Otevřená a uzavřená připojení.
Duration (ms), Fetches, Reads, Writes, Marks Součty pro databázi, program nebo adresu.
Unique plans, Unique statements, Uniq. connections Kolik různých plánů, příkazů a připojení.

Otevřený řádek. Kliknutím na řádek žebříčku jej otevřete. Zobrazí:

  • SQL: s tlačítky pro kopírování, Plan: a Parameters:. Když trace zkrátil text (max_sql_length), upozorní na to poznámka.

  • Table stats: pouze počítadla, která trace Firebird poskytuje pro každou tabulku: natural, index, update, insert, delete, backout, purge a expunge. Fetches, reads, writes a marks existují pouze pro příkaz jako celek.

  • Rozložení napříč běhy: Min, Avg, Median, Max, Sum a % okna u každé metriky.

  • Běhy po hodinách: běhy a % trvání v každé hodině.

  • Podrobnosti: vzorový běh příkazu: Doba běhu, zda skončil chybou, Neúspěšné běhy, Databáze, Proces, Adresa klienta, ID připojení, ID příkazu, Řádek trasování, Hash příkazu, Hash plánu a nejčastější databáze a adresy. Pole, které sestava nemá, se vynechá.

  • Trasování této minuty (v Podrobnostech): otevře stránku databáze v minutě vzorového běhu, takže můžete vidět trasování a připojení této minuty. Zobrazí se pouze tehdy, když konzole databázi zná.

  • Historie, 30 dní: tabulka příkazu v každém okně za posledních 30 dní: Okno, Počet, Celkem, ms (s pruhem) a Průměr, ms. Kliknutím na okno jej otevřete. Sestava obsahuje pouze top každého žebříčku. Takže okno, kde příkaz nebyl v topu, uvádí not in the top. Neznamená to, že se příkaz nespustil. other grouping znamená, že toto okno seskupuje příkazy jiným způsobem (podle plánu nebo podle SQL).

Řádky DATABASES, PROCESSES a ADDRESSES se neotevírají.

Hledání. Pište do Search in SQL, plan, process, address. Všechny tabulky zobrazují pouze řádky, které obsahují text. „No rows match the search." znamená, že žádný řádek tabulky text neobsahuje.

Porovnat s. Zvolte Previous window, One day earlier, One week earlier nebo Other window… (pak zvolte datum a čas). Tabulka Changes against <window> zobrazuje každý příkaz v obou oknech: Statement, Runs A, Runs B, Total A, ms, Total B, ms, Change, ms, Avg A, ms a Avg B, ms. A je otevřené okno, B to druhé. Zvolte Nothing pro skrytí tabulky.

Zpráva Co znamená
The windows group statements in different ways (by plan and by SQL). They cannot be compared. Zvolte jiné okno.
The windows differ in length by more than 10 %. Compare the numbers with care. Součty nejsou za stejné období.
The other window is an incomplete report. Jeho čísla pokrývají jen část jeho okna.
not in the top of the other window Příkaz je v topu pouze jednoho okna.
No such window. Agent nemá pro tento čas sestavu.

Databáze. Zvolte databázi, chcete-li vidět pouze její řádky. All databases zobrazí všechny. Položka Performance report na stránkách databáze otevře tuto stránku s již zvolenou databází. Čísla řádku stále pokrývají všechny databáze, kde se příkaz spustil („A row’s numbers cover all databases the statement ran in."). Tabulka DATABASES označuje zvolenou databázi.

Zatímco je databáze zvolena, řádek databáze stránek databáze se zobrazuje pod záhlavím: štítek DB, název databáze a stránky této databáze. Klikněte tam na Database nebo Metrics pro jejich otevření pro stejný den. Řádek se zobrazuje pouze pro databázi, kterou konzole zná (je v tabulce Databases na dashboardu). All databases řádek skryje.

The database row on the Perf Report page
The database row on the Perf Report page

Download JSON uloží soubor sestavy agenta tak, jak je.

Ze zdravotní sestavy. Tlačítko Perf report v sekci Queries zdravotní sestavy otevře tuto stránku v okně, které obsahuje čas stavu. Řádky tohoto dotazu jsou označeny modrým pozadím a pruhem vlevo. První je otevřený a na obrazovce; tabulka v případě potřeby zobrazí všechny řádky. Když zvolíte jiné datum nebo čas, označení zmizí.

Starý formát sestavy má jednu tabulku a souhrnná pole Lines processed a Records created.

Okno bez sestavy. Někdy agent okno uzavře a jeho sestavu nikdy nevytvoří. Místo sestavy pak zapíše malý soubor. Seznam časů zobrazuje takové okno s krátkou poznámkou:

Poznámka Proč sestava není
build aborted Sestavení tohoto okna bylo příliš mnohokrát zastaveno. Agent to už nezkusí.
build failed Sestavení tohoto okna příliš mnohokrát selhalo.
too many trace files Okno má více trasovacích souborů, než může jeden běh zpracovat (max_files_per_run).
expired Okno bylo při příchodu na řadu starší než limit zpracování (horizon_days).
no trace data Pro okno nebyla žádná trasovací data.
trace files not usable Trasovací soubory okna nebylo možné použít.

Klikněte na takový čas: stránka zobrazí jednu větu s vysvětlením a žádné prázdné tabulky. Při otevření stránka zobrazí nejnovější skutečnou sestavu, ne takové okno.

Sestavy na vyžádání

Sestava na vyžádání pokrývá rozsah, který zvolíte, například 40 minut pomalého období. Nemění naplánovaná okna.

The Build report form
The Build report form

Postup vytvoření:

  1. Klikněte na Build report…. Otevře se formulář Build a report on request.
  2. Nastavte Start a End. Jsou v čase agenta, stejné hodiny jako okna. Rozsah je ve výchozím nastavení nejvýše 24 hodin.
  3. Volitelně: zvolte Database (All databases, databázi serveru nebo Other… s Database name), Threshold, ms (pouze příkazy, které běžely alespoň tak dlouho) a Process filter.
  4. Klikněte na Build. Close zavře formulář bez požadavku.

Požadavek jde stejnou cestou jako Run now v editoru konfigurace (viz Run now): přímo agentovi vedle konzole, přes HQCenter vzdálenému agentovi. Stránka sleduje běh: „Request sent, waiting for the agent to take it", „The agent is building the report", „Report built". Cancel run jej zastaví. Když soubor dorazí, stránka otevře sestavu: „Report built and opened."

Seznam Reports on request zobrazuje sestavy, které agent vytvořil, s rozsahem, filtry a stavem. Zvolte jednu pro otevření. Zvolte Scheduled windows pro návrat k oknům. Otevřená sestava na vyžádání má nad souhrnem řádek Report on request s rozsahem a filtry. Nemá Compare with ani History, 30 days. Agent uchovává 20 nejnovějších takových sestav.

Tlačítko vyžaduje fbagent 3.3.0 nebo novější a právo spouštět úlohy (viz Add or edit a user). Agent vytváří jednu sestavu na vyžádání najednou. Když je tlačítko vypnuté, najeďte na něj myší a zjistíte proč, například „You may not start jobs on this agent." nebo „The agent is too old to take this job.". Stránka pak také zobrazuje příkaz, který vytvoří stejnou sestavu na agentovi: fbagent --process-perf-report --start YYYYMMDD_HHMM --end YYYYMMDD_HHMM --on-demand.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No perf report files found. Agent nezapsal žádnou sestavu výkonu.
No data for the selected time. Zvolená sestava je prázdná.
The query from the server report is not in the top lists of this report. Přišli jste ze zdravotní sestavy, ale toto okno nemá dotaz ve svých top seznamech.
No data for this database in this window. Zvolená databáze nemá v této sestavě žádné řádky.
A report is being built. Agent vytváří jinou sestavu na vyžádání. Počkejte, až skončí.
The range is longer than 24 hours. … Zkraťte rozsah.
Expired: the agent did not take the request in time Agent požadavek včas nepřevzal. Zkontrolujte, že běží a synchronizuje se.
This report on request was removed: … Agent uchovává pouze 20 nejnovějších. Stránka zobrazuje naplánovaná okna.
Failed to load perf report: …, Failed to load dates: …, Failed to load times: … Konzole nemohla načíst data. Text uvádí důvod.

8. Sestava stavu serveru

Server health report (/report) kombinuje snímky stavu agenta a jeho AI sestavu pro jeden den. Otevřete ji pomocí:

  • odkazu Report ve sloupci Status na stránce Servers,
  • buňky Server strip nebo
  • odkazů Server status a Report for this minute na dashboardu.
The server health report
The server health report

Co uvidíte

  1. Záhlaví: Server health report, odznak časového pásma, seznam AI a seznam Status s ← a →.
  2. System state: stav každého systému za dané období.
  3. Totals for 24 h (nebo zvolené období): čas na úrovni a seznam problémů.
  4. Report for DD.MM HH:MM: verdikt zobrazeného snímku a jeho změny.
  5. Sestava snímku: soubory, klíčová fakta, souhrn, oblasti, klíčové ukazatele a zjištění.
  6. Sekce Errors, Queries a Backups.
  7. Panely Sources a Agent a řádek dalších čítačů.
  8. System details: jeden panel na systém.

Všechny časy na stránce jsou v časovém pásmu agenta. Data pocházejí ze snímků stavu agenta (přibližně jeden za 10 minut) a jeho AI sestav.

  • Odkaz bez data otevře den nejnovějšího snímku.
  • Odkaz může končit sekcí, například #area-backups nebo #report-backups. Stránka se pak otevře u této sekce a na chvíli ji označí.
  • V demo režimu stránka maskuje názvy serverů a databází a každou složku a název souboru v cestě, také uvnitř klíčů zjištění. Oddělovače a přípona souboru zůstávají.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Choose a server: the server query parameter is required. Odkaz nemá server. Otevřete sestavu ze stránky Servers nebo z dashboardu.
No report data for the selected date. Agent pro tento den neposlal žádný snímek stavu ani AI sestavu. Seznamy v záhlaví jsou skryté.
No server_status snapshots in this period Matice System state nemá pro dané období žádná data.
invalid status snapshot / invalid ai report Konzole nemohla soubor přečíst. Zvolte jiný čas v seznamech záhlaví.

Stav systému za období

Horní část stránky zobrazuje server za období.

  • Period: 24 h, 7 days nebo 14 days. Období končí na konci dne sestavy, nebo nyní pro dnešek. Zůstává, když v něm otevřete jiný snímek. Zatímco se načítají starší dny, stránka zobrazuje Loading….
  • System state: jeden řádek pro Server a jeden řádek pro každý systém: CPU, Memory, OS limits, Disks, Disk speed, firebird.log, Trace errors, Transactions and GC, Locks, Queries, Connections, Indexes, Backups, fbagent jobs, Replication, fbagent agent, Security and license. Other findings je řádek pouze tehdy, když měl problém. Tečka před názvem ukazuje nejhorší úroveň tohoto řádku.
    • Buňka je 1 hodina (24 h), 4 hodiny (7 days) nebo 6 hodin (14 days). Zobrazuje nejhorší úroveň v daném čase. Legenda vysvětluje barvy: červená je serious, oranžová je warning, zelená je OK, šrafovaná je no snapshots. Buňka s modrým rámem je snapshot in the report. Najeďte na buňku myší a zobrazí se její čas, systém a úroveň.
    • Kliknutím na buňku otevřete sestavu v daném čase. Kliknutím na název systému otevřete

jeho panel v System details.

  • Snapshot zobrazuje úroveň ve zobrazeném snímku. U CPU, Memory, Disk speed a Connections zobrazuje hodnotu (například 8.9 %, 0.2 ms, 1160).

  • Since zobrazuje, od kdy má systém tuto úroveň: since 10:40, nebo since 03.11 00:00, pokud začala jiný den.

  • only systems with problems in the period skryje řádky, které byly po celou dobu v pořádku, a vypíše jejich názvy za OK for the whole period:.

  • Totals for 24 h: dlaždice Serious, Warning, OK a No snapshots zobrazují, jak dlouho měl server každou úroveň. Problems zobrazuje, kolik měl problémů, se závažnými pod tím. Dlaždice s hodnotou větší než nula je barevná. Tabulka níže vypisuje každý problém:

    Column What it shows
    Start Kdy problém začal. ≤ znamená, že začal před obdobím.
    End Kdy skončil. still active znamená, že je stále otevřený; active at the end znamená, že byl otevřený, když skončilo minulé období.
    Duration Jak dlouho trval.
    Level Odznak úrovně.
    System Systém problému.
    Finding Klíč nálezu.

    Kliknutím na řádek nebo stisknutím Enter na něm otevřete report v daném čase. Tabulka zobrazuje až 300 řádků, poté … more not shown. Bez problémů se zobrazí No problems in this period.

  • Report for DD.MM HH:MM: úroveň a hlavní řádek zobrazeného snímku. U staršího snímku banner říká Snapshot from history: <time> a To the latest snapshot of the period otevře nejnovější snímek. Dva řádky štítků zobrazují změny:

    • Since the previous snapshot: změna oproti předchozímu snímku.
    • Over the period: změna oproti prvnímu snímku období.
    • + key je nový nález, ↑ key je nález, který se zhoršil (warning na serious), − key je nález, který zmizel. no changes znamená, že se nic nezměnilo.

Report snímku

Pod sekcemi období zobrazuje report jednoho snímku:

  • Seznamy AI a Status (v záhlaví): vyberte starší AI report nebo snímek stavu ze stejného dne. Latest AI a Latest status jsou nejnovější. Tlačítka ← a → vedle seznamu Status otevírají předchozí a následující snímek stavu, také přes půlnoc (najeďte na tlačítko a uvidíte čas). Tlačítko Back v prohlížeči se vrací přes snímky, které jste otevřeli.
  • Selected files: názvy dvou souborů, nebo No status snapshot for date / No AI report for date. Varování jako Status and AI timestamps differ by 190 min znamená, že dva soubory byly vytvořeny více než 15 minut od sebe.
  • level (například WARNING), odznak HQbird a řádek klíčových faktů. Úroveň je úroveň serveru z verdiktu agenta; snímek bez verdiktu zobrazuje svou starou závažnost. Malý odznak Agent: LEVEL následuje pouze tehdy, když je úroveň samotného agenta horší. Klíčové fakty jsou: verze agenta a Firebird, Mode Firebirdu (SuperServer, SuperClassic nebo Classic; fbagent 2.94.0 nebo novější), počet databází, připojení (se změnou, například (Δ+12)), hlavní a sekundární bottleneck a čas stavu a AI reportu. Když firebird.conf nastavuje jiný režim, poznámka za režimem to uvádí, například “firebird.conf sets Classic: it takes effect after a Firebird restart”.
  • Text summary AI reportu.
  • Areas: štítky jako engine_errors, io, queries, backups, clients, agent, cpu. Barevný štítek má nálezy a zobrazuje, kolik jich je. Kliknutím na něj přejdete k nálezům dané oblasti. Šedý štítek nemá žádné nálezy a není odkazem.
  • Key indicators: dlaždice ze snímku stavu. Dlaždice je odkazem pouze tehdy, když je její sekce na stránce.
    Tile What it shows Click goes to
    ERRORS Chyby trace daného dne, s chybami LWM pod tím (today · LWM 1.92M). Její barva se řídí otevřenými nálezy u chyb trace a LWM: červená je serious, jantarová je warning, žádná barva znamená žádný nález nebo potvrzený nález. Sekce Errors
    LONG_TX Počet dlouhých transakcí. Pouze když nějaké jsou. Není odkaz
    LWM_LAST Čas nejnovějších dat LWM. Jantarová s stale …s, když zdroj lwmmon je opožděný. Panel Sources
    AGENT_LOGS Složka logů agenta v procentech jejího limitu a velikost (3.00 / 3 GB). Červená při 100 % nebo více. Panel Agent
    RESOURCE_GUARD Stav resource guardu agenta, například cooldown. Panel Agent
    CPU_HOST CPU % a pod tím zátěž a ram %. S avg 10m jsou čísla 10minutové průměry, stejně jako v matici System state. Starší snímek zobrazuje hodnoty daného okamžiku, s použitou a celkovou RAM. Ztlumené s — a cpuram missing, když agent neposlal žádná data o hostiteli. Nálezy cpu; odkaz pouze tehdy, když má snímek nález CPU

Níže jsou findings, ve skupinách podle oblasti v pořadí štítků. Každá skupina zobrazuje svůj počet. V každé skupině je nejzávažnější nález první. Nálezy AI reportu, které nemají oblast, jsou v poslední skupině, other. Skupiny queries a backups mají odkaz na svou tabulku: → query table a → backup table.

Findings of the health report
Findings of the health report

Karta nálezu má tyto části:

  • Záhlaví: odznak závažnosti (SERIOUS, WARNING, …), NEW pro nález, který je nový od předchozího snímku, klíč nálezu (například backups/none//data/employee.fdb) a zdroj: status (snímek stavu), ai (AI report) nebo status + ai (uvádějí ho oba).
  • Název: co agent našel.
  • Z AI reportu: Explanation, Impact a Next checks. Evidence se zobrazuje, když se liší od názvu.
  • Ze snímku stavu: krátký Hint, například “configure nbackup/vbackup or scan paths”.
  • Nálezy filesystem_warnings a filesystem_errors mají blok Found: cesty, které našla kontrola souborového systému agenta (až 5, s důvodem) a Checked at <time>. Agent novější než fbagent 3.1.0 zapisuje složky, problémy a čas kontroly do názvu. Blok Found pak vypisuje pouze problémy, které název neuvádí, takže složka je uvedena jednou. U staršího agenta má název pouze počet a blok vypisuje všechny cesty.
  • Action buttons, když konfigurace agenta může nález opravit. První tlačítko je hlavní.
  • Nález s hodnotou ji zobrazuje proti svému limitu na jednom řádku, například 476.5 MiB / 1 GiB nebo 25.2 h / 1 h. Každé číslo má svou vlastní jednotku.

Každý aktivní nález má kartu. Novější agent vypisuje všechny své nálezy, ale text dává pouze pro 15 nejhorších. Nález bez textu je krátká karta pouze s klíčem. Tabulka Backups má také řádek pro každý nález zálohy, i nad 15. Nález front zpracování, například queue/conflict_trace_queue_age_seconds, zobrazuje text a hint agenta jako svůj název (agent 2.90.0 a novější), nejen svůj klíč.

Opakované nálezy sdílejí jednu kartu. Tři nebo více nálezů se stejným klíčem, začátkem a stejnou úrovní, například 13 zdrojů replikace, které agent nemůže číst, jsou jedna karta. Karta vypisuje objekty: název, text, od kdy a NEW. Prvních 10 je otevřených; Show N more zobrazí zbytek. Tlačítko opravy pro jednu databázi zůstává vedle této databáze. Tlačítko, které sdílejí všechny objekty, se zobrazí jednou na kartě. Nálezy takto spojují pouze snímky s verdiktem (schéma 26 nebo novější). Štítky oblastí a počty skupin stále počítají každý nález.

Action buttons. Tlačítko otevře Agent configuration editor na daném místě: přidá úlohu pro databázi, otevře úlohu nebo její řádek, nebo zobrazí nastavení. Příklady: Add an nbackup job, Add a gbak backup job, Set the .nbk scan folders, Set the .fbk scan folders, Open the backup scan settings, Open the Backups page, Add an index statistics job, Edit the ignored firebird.log errors, Open the job.

  • Editor nic neuloží, dokud nekliknete na Save. Pokud úloha pro tuto databázi již existuje, editor ji otevře a nepřidá druhou.
  • Tlačítka vidíte pouze tehdy, pokud smíte otevřít editor pro tento server, a pouze tehdy, pokud server má konfiguraci agenta.
  • Řádek v tabulce Backups má pouze hlavní tlačítko.
Backup findings with action buttons
Backup findings with action buttons

Sekce Errors, Queries a Backups

Po nálezech následují sekce Errors, Queries a Backups. Sekce se zobrazí pouze tehdy, když má data.

The Errors section and the Backups table
The Errors section and the Backups table

Errors: chyby trace daného dne. První řádek je Trace: 893 today · LWM: 21892 today (0 per connection). Část v závorkách vyžaduje agenta, který ji posílá. Tabulka obsahuje pět nejčastějších druhů chyb trace:

Column What it shows
Class Třída chyby a její kód Firebird, například io_open 335544344.
Error Text chyby.
Count Kolik takových chyb daný den má.
Share Podíl na všech chybách trace daného dne.
Databases V kolika databázích k chybě došlo.

All errors → otevře stránku Errors pro daný den. Druhy chyb vyžadují agenta, který je posílá.

Queries: nejlepší dotazy ze snímku stavu a AI reportu.

Column What it shows
# Pořadí.
Source status nebo ai.
DB Databáze.
Avg s Průměrná doba běhu v sekundách.
Runs Kolikrát se dotaz spustil.
SQL Text dotazu. Kliknutím na Plan zobrazíte plán provádění. Perf report otevře okno Perf Report, které obsahuje čas stavu a označí tam dotaz. Než agent toto okno zapíše, buňka říká No Perf report for this time yet. Když agent okno zavřel bez reportu, buňka říká No Perf report for this time: a důvod. Dotazy od staršího agenta nemají tlačítko.

Backups: jeden řádek na každý nález zálohy.

The Backups table, the Sources and Agent panels
The Backups table, the Sources and Agent panels
Column What it shows
DB Úplná cesta databáze, i na Linuxu, například /data/employee.fdb. Nález pro celý server zobrazuje —. Řádek, který uvádí pouze AI report, zobrazuje název, který AI použila.
Kind Druh nálezu: none (žádná záloha), nbackup_locked (databáze je v zámku nbackup), stale, nbk_missing a tak dále.
Since Kdy nález začal: 19:30, nebo 11-02 19:30, když začal dřívější den.

| AI | ✓, pokud se tato databáze uvádí také ve zprávě AI. | | (poslední sloupec) | NEW u nového zjištění, poznámka jako OIT gap (AI) a hlavní tlačítko akce. |

Sources a Agent jsou dva panely vedle sebe.

Sloupec Sources Co zobrazuje
Source Zdroj dat agenta, například cpuram, lwmmon, diskio.
State ok, stale (opožděné) nebo missing. Opožděný nebo chybějící řádek je označen.
Age Čas od nejnovějších dat zdroje, například 57s, 4m, 1h nebo 24h.

Panel Agent zobrazuje vlastní stav agenta: severity, failing (selhávající úlohy), logs disk (procento limitu a velikost), self_repair (opravy za posledních 24 hodin a poslední oprava) a resource_guard (stav a čas posledního zásahu). Řádek se zobrazí jen tehdy, když má hodnotu.

Pod panely zobrazuje řádek počítadla, která má pouze snímek stavu, například lock_conflicts_today 674 · conflict_reports_today 266.

Podrobnosti systému

System details na konci stránky má jeden panel pro každý systém (ne pro řádek Server). Other findings má panel jen tehdy, když měl problém. Řádek každého panelu zobrazuje název, odznak úrovně a aktuální hodnotu. Panel je otevřený, když měl systém problém v daném období nebo ho má nyní.

System details: one panel per system
System details: one panel per system
  • CPU, Memory a Disk speed mají graf 10minutového průměru s čárkovanými čarami prahových hodnot: Thresholds: warning X, serious Y (10-minute average). Disk speed je latence zápisu nejhoršího databázového disku. Jeho číselný řádek je read … ms · write … ms · worst minute … ms · … MB/s.
  • Connections má graf připojení.
  • Ostatní systémy mají barevný pruh své úrovně.
  • Modrá čára označuje zobrazený snímek. Kliknutím na graf otevřete zprávu pro daný čas.
  • Pod grafem jsou zjištění zobrazeného snímku s odkazy na jejich skupinu ve zprávě, nebo No active findings in this snapshot.
  • Tlačítko otevře stránku, která pomůže dále: Dashboard (CPU, Memory, Disk speed, Connections), firebird.log (stránka Logs), Errors (Trace errors) nebo Performance report (Queries).

Tabulky v panelech. Čtyři panely také zobrazují čísla, která agent naměřil v zobrazeném snímku. Tabulka zobrazuje prvních 10 řádků a Show N more. Hodnota, kterou agent vynechal, je prázdná buňka nebo žádný řádek. Snímek bez těchto čísel zobrazuje panel bez tabulek.

  • Disks: Volumes (svazek, k čemu se používá, využito %, volné, celkem) a Temp folders (složka, zdroj, svazek, volné, celkem, úroveň). Svazek, který měřilo zjištění agenta o volném místu, má svou úroveň a je uveden první.

    The Disks panel with its Volumes and Temp folders tables
    The Disks panel with its Volumes and Temp folders tables
  • Transactions and GC: Databases (OIT gap, OAT gap, OAT gap in time, transakce za minutu, dlouhé transakce), první je databáze s nejvíce dlouhými transakcemi; a Long transactions (stáří, databáze, uživatel, proces, adresa), první nejstarší. Sloupec se zobrazí jen tehdy, když pro něj má řádek hodnotu. Na obrázku snímek nemá OAT gap in time, takže tabulka takový sloupec nemá. Když snímek počítá více databází, než uvádí, je to uvedeno v poznámce.

    The Transactions and GC panel with its databases and long transactions
    The Transactions and GC panel with its databases and long transactions
  • Replication: Masters (databáze, segmenty v archivu, velikost archivu, nejstarší segment) a Replicas (databáze, čekající segmenty, velikost čekajících, zpoždění, naposledy aplikováno, chyba). Řádky s chybou jsou první, pak nejdelší zpoždění nebo největší archiv. Sloupec se zobrazí jen tehdy, když pro něj má řádek hodnotu.

  • fbagent agent: vlastní zdraví agenta. Agent state (uptime, restarty za 24 h, soubory čekající na nahrání a nejstarší z nich, neúspěšná nahrání v řadě, poslední úspěšné nahrání, chyby v logu za 1 h a 24 h, poslední self-update, resource guard, CPU a paměť agenta) zobrazuje všechny své řádky. File queues (lock konflikty, trace, performance report: soubory, velikost, nejstarší soubor) a Top tasks, last 15 min (CPU čas, spuštění, růst paměti, skóre).

    The fbagent agent panel: agent state, file queues and top tasks
    The fbagent agent panel: agent state, file queues and top tasks

V demo režimu jsou názvy databází, uživatelé, procesy, adresy, cesty a texty chyb v těchto tabulkách maskovány.

display density na stránce Settings zmenšuje nebo zvětšuje text zprávy.


9. Editor konfigurace agenta

Editor konfigurace agenta má tři stránky:

  • Jobs otevírá editor. Má karty Jobs, Settings, Problems a Activity.
  • Backups otevírá inventář záloh serveru.
  • Activity zobrazuje, jak probíhaly úlohy plánovače agenta.

Odkazy Jobs a Backups se v horním menu zobrazují jen tehdy, když má konzole konfiguraci agenta. Horní menu označuje Jobs na stránkách Jobs a Activity a Backups na stránce Backups.

Uživatelská příručka fbagent user guide podrobně popisuje každou úlohu a nastavení. Tato kapitola vysvětluje stránky.

The configuration editor: Jobs tab
The configuration editor: Jobs tab

Co vidíte

  1. Záhlaví konzole: ← Servers, název serveru, horní menu a řádek s drobečkovou navigací, například Servers › SRV › Jobs.
  2. Záhlaví editoru: soubor, který editor otevřel, datový odznak, ↻ Refresh a tlačítka pro uložení vpravo.
  3. Řádek s poznámkou pod záhlavím. V režimu remote uvádí, že stránka zobrazuje kopii konfigurace agenta.
  4. Karty Jobs, Settings, Problems (s počtem problémů) a Activity. Odznak TZ je na pravém konci řádku karet.
  5. Tabulka úloh ve skupinách: Backups, Restore, Maintenance, Performance monitoring, SQL update, Health-check a System jobs.
  6. Dole: tabulka Scheduler tick tasks.

Záhlaví editoru

  • ← Servers vás vrátí na stránku Servers. Řádek s drobečkovou navigací ukazuje, kde jste: Servers › SRV › Jobs, Servers › SRV › Jobs › Activity nebo Servers › SRV › Backups. Kliknutím na jeho část se tam přesunete.
  • Soubor, který editor otevřel. V režimu remote je to nejnovější snímek konfigurace, který agent odeslal.
  • Datový odznak, například DATA: 3 DATABASES · LAST RUNS · AGENT 3.4.0. Ukazuje, co editor zná z dat agenta: seznam databází, poslední spuštění úloh a verzi agenta. Najeďte na něj myší a zobrazí se složka s daty, čas seznamu databází, kolik databází bylo připojeno v posledním záznamu a kdy editor data načetl.
  • ↻ Refresh znovu načte data agenta: výsledky úloh, poslední spuštění a zaznamenané příkazy.
  • Discard changes zahodí neuložené změny. Po úpravě se zobrazí značka unsaved changes s počtem. Najeďte na ni myší a zobrazí se změněné sekce.
  • Tlačítka pro uložení. Závisejí na režimu (viz Saving: local mode a Saving: remote mode). Uložení proběhne okamžitě, i když je kurzor stále v poli, do kterého píšete.
  • Open se v režimu remote zobrazí, když existují koncepty. Vypíše konfiguraci agenta a vaše koncepty.
  • Odznak TZ: časové pásmo agenta (agent.timezone), jeho posun od UTC a aktuální čas v něm. Plány používají toto pásmo. Najeďte na odznak myší a zobrazí se rozdíl oproti času vašeho prohlížeče. Kliknutím na něj pásmo nastavíte. Když je pásmo prázdné, odznak zobrazuje TZ not set: plány pak sledují pásmo hostitele agenta.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
RUNTIME: OFFLINE (místo datového odznaku) Editor nenašel žádná data agenta. Sloupce Last run a Result zůstanou prázdné.
Refresh failed — the editor could not read the agent runtime files ↻ Refresh nefungovalo. Zkuste to později znovu.
This page shows a copy of the agent’s configuration. Edit it, then click Save and Send to agent. The agent applies your change in about a minute. Režim remote s doručováním. Stránka zobrazuje tento řádek také na stránkách Backups a Activity.
Reading a copy of the agent’s configuration. This console cannot deliver an edit to the agent; download the JSON and apply it on the agent host. Režim remote bez doručování. Konfiguraci můžete číst, ale nemůžete odeslat změnu.
… the file the agent writes this from did not arrive with the logs. Jedna část dat agenta na konzoli chybí. Řádek uvádí kterou, například The Last run column nebo The database picker.
… no agent data tree was found beside this configuration. Konzole má konfiguraci, ale žádná data agenta.
… the newest records are older than this agent should be producing, so what is shown is not current. Data agenta jsou stará. Na konzoli obvykle přinese nová data další balík logů.
… the file is in a newer format than this editor reads. Agent je novější než editor. Aktualizujte HQ Monitor.
The Result column is empty because the agent did not send the job-start information. Agent neodeslal výsledky úloh.

Karta Jobs

Úlohy jsou ve skupinách. Záhlaví skupiny uvádí, kolik úloh je zapnuto, například 1 of 2 enabled. Skupina Restore je označena destructive · designed for forced runs: tyto úlohy jsou určeny pro Run now, ne pro plán.

Každý řádek je jeden typ úlohy:

Sloupec Co zobrazuje
(+) Otevře řádek: úlohy tohoto typu, jejich možnosti a poslední spuštění.
Job Název a úloha plánovače, například process_traces. Malé odznaky uvádějí další skutečnosti, například PER-DB (jedno spuštění na databázi) nebo ALIAS: DUMP_BACKUP (starý název úlohy dump_backup spouští stejné úlohy).
Actions + Add job pro typy úloh, které obsahují seznam úloh (například jedna úloha zálohy na databázi). Seznam Enabled / Disabled pro ostatní řádky. Clear & enable, když úlohu zastavil resource guard.
Status Zda úloha běží (viz tabulka níže). Pod slovem stavu může být krátký důvod.
Schedule Cron úlohy. per job znamená, že každá úloha seznamu má vlastní plán. on tick znamená, že úlohy běží při každém tiku úlohy. continuous je úloha, která běží neustále. Řádek Performance test také zobrazuje své prováděcí okno se dny v týdnu.

| Poslední spuštění | Kdy úloha nebo job naposledy proběhl, v čase agenta, ve 24hodinovém formátu. | | Výsledek | OK, ERROR, NEVER (nikdy neproběhlo) a další (viz níže). | | Podrobnosti | Na čem job pracuje, například server FBK/NBK stores nebo host. |

+ Add job přidá job a posune zobrazení k jeho formuláři. První job běžného typu jobu také zapne jeho sekci a vytvoří jeho úlohu plánovače. Když smažete poslední job, editor úlohu odstraní. Destruktivní typ jobu (Restore, SQL update) se sám nikdy nezapne: nový job tohoto typu se vytvoří vypnutý.

Stav. Job běží jen tehdy, když jsou zapnuté dva přepínače: příznak jeho sekce a jeho úloha plánovače. Sloupec Status ukazuje oba. Když oba přepínače říkají něco jiného, důvod je napsán malým textem pod slovem stavu.

Stav Význam
Enabled Oba přepínače jsou zapnuté.
n z m on Seznam jobů: n z jeho m jobů je zapnuto.
0 z m on, s all jobs off pod tím Sekce a úloha jsou zapnuté, ale každý job seznamu je vypnutý. Import z HQbird nechává typ jobu takto záměrně: importuje joby vypnuté, abyste je zkontrolovali.
Disabled Oba přepínače jsou vypnuté. no tick row pod tím: plánovač nemá pro tento typ jobu žádnou úlohu.
gates differ Jeden přepínač je zapnutý a druhý vypnutý. Job neběží. Důvod pod tím říká, který je vypnutý: section off, section off (default), tick off nebo no tick row.
no jobs Seznam jobů je prázdný. + Add job vytvoří první.
not present Plánovač nemá pro tento job žádnou úlohu a job je ve výchozím stavu vypnutý.
row missing Job je ve výchozím stavu zapnutý, ale plánovač pro něj nemá žádnou úlohu.
Suspended Resource guard agenta úlohu prozatím zastavil. Guard je pojmenován pod tím, například by resource_guard.

Výsledek. Seznam jobů ukazuje nejhorší výsledek svých zapnutých jobů.

Výsledek Význam
OK Poslední spuštění proběhlo úspěšně.
WARN Poslední spuštění skončilo s varováním.
ERROR Poslední spuštění selhalo. Najeďte na něj myší a uvidíte chybu.
RUNNING Job právě běží.
DEFERRED Job čekal na jiný job, například na zámek databáze. To není chyba.
STALE Stavový soubor ve složce jobu patří jinému jobu nebo jiné databázi, takže to není výsledek tohoto jobu. Dejte jobu vlastní složku.
NEVER Job nikdy neproběhl.
NOT HERE Stavové soubory jobu zůstávají na hostiteli agenta a nedorazily do této konzole. Job přesto může běžet normálně.
TICK OK / TICK ERR Stránka nemá výsledek pro každý job, takže ukazuje výsledek posledního tiku plánovače.

overdue (every Nm) pod časem Last run znamená, že úloha neproběhla déle než trojnásobek svého obvyklého intervalu N minut.

Skupina Restore. Pod hlavičkou Restore je jeden řádek: zaškrtávací políčko Confirm to enable potentially destructive jobs s klíčem restore.enabled. Je to příznak sekce všech tří typů restore jobů, takže se editor ptá jen jednou. Každý restore job si zachovává svůj vlastní přepínač Enabled. Skupina SQL update se na totéž ptá ve svém otevřeném řádku.

Otevřený řádek ukazuje své joby, jeden řádek na job:

  • zaškrtávací políčko, které job zapíná nebo vypíná;
  • id jobu, Configure ▾ (nebo Hide settings ▴, když je formulář otevřený), Delete a Run now;
  • N required empty, když jsou povinná pole prázdná. Klikněte na Configure ▾: prázdná pole mají červený rámeček. Při uložení editor takový job vypne;
  • plán jobu, s DEFAULT, když job nemá vlastní plán, a příští spuštění, například next run 11-07 02:00, sampled by the restore tick;
  • poslední spuštění a výsledek;
  • Details ▾: poslední výsledek jobu (viz Job logs). Hide details ▴ jej zavře.

Řádek bez seznamu jobů (například Host CPU / RAM nebo Disk IO) má tlačítko <section>.* section fields. To otevře pole této sekce, například agent switches.

Skupina Health-check má řádek Disk IO (collect_disk_io): agent měří latenci čtení a zápisu a propustnost disků s databázemi a dočasnými soubory jednou za minutu. Ve výchozím stavu je zapnuto (fbagent 2.87.0 nebo novější). Jeho data tvoří disk IO charts na dashboardu.

Schedule používá šest polí, sekundy první: second minute hour day month weekday. Například 0 */2 * * * * je každé 2 minuty a 0 0 */2 * * * jsou každé 2 hodiny. Formulář jobu ukazuje šest polí jedno po druhém (SEC, MIN, HOUR, DOM, MON, DOW) a říká, v jakém časovém pásmu je agent čte.

Úlohy tiku plánovače. Tabulka ve spodní části karty vypisuje řádky scheduler.tasks. Editor tyto řádky vytváří a odstraňuje spolu s jejich joby.

Sloupec Co ukazuje
Task Název úlohy. Odznaky: retired, unknown, alias, guard, no jobs.
Runs for Typ jobu, který úloha spouští.
Schedule Cron tiků úlohy.
Timeout, s Časový limit jednoho spuštění v sekundách. 0 znamená bez limitu.
On Zda je úloha zapnutá.
Last run Kdy úloha naposledy proběhla.

Zprávy, které můžete vidět

Zpráva Co znamená
No jobs yet — Add job creates the first one. Otevřený řádek nemá žádné joby.
No recorded run for this job yet. Agent nemá žádné spuštění tohoto jobu.
No scheduler.tasks rows in this config — adding a job creates the one it needs. Tabulka plánovače je prázdná.
Warning: an enabled … job re-runs on every tick — prefer forced runs Zapnuli jste job destruktivního typu. Preferujte Run now.

Formuláře jobů

Každý formulář jobu (vbackup, nbackup, nbackup dump, sweep, index statistics, backup-restore cycle) ukazuje svá pole v pojmenovaných skupinách, ve dvou sloupcích.

A vbackup job form with its field groups
A vbackup job form with its field groups

Co vidíte

  1. Řádek jobu: id jobu a databáze, Hide settings ▴ (zavře formulář), Delete, Run now, štítek plánu, výsledek (zde ERROR s důvodem) a Details ▾. Zaškrtávací políčko vlevo job zapíná nebo vypíná.
  2. Expand all a Collapse all.
  3. Skupiny. Na obrázku: Database and schedule (databáze, políčko Enabled a pole plánu), Backup files, gbak a Free space calculation factors. Compression a After the backup jsou níže na formuláři.

Jak skupiny fungují:

  • Kliknutím na název skupiny ji sbalíte nebo otevřete. Expand all a Collapse all provedou totéž pro všechny skupiny. Sbalená skupina ukazuje krátký souhrn ve svém názvu: hodnoty, na kterých záleží, not set nebo set: N (N polí má hodnotu).
  • Vzácné skupiny jsou pod More settings. Poslední skupina, All fields — N more not on the legacy dialog, obsahuje pole, která žádná jiná skupina neukazuje.
  • Skupina s prázdným povinným polem (červené) nebo varováním (žluté) se otevře sama a její název ukazuje, kolik polí je označeno. Prázdné povinné pole má červený rámeček a slovo required.
  • Skupina o jedné funkci má svůj přepínač v názvu: S3 streaming, file transfer, test restore, disconnect before sweep. Vypnuto zešedne pole a zachová jejich hodnoty.

Seznam databází. Pole databáze nabízí databáze, které agent našel, a ty, které pojmenovává databases.conf, s jejich aliasy. Na Firebird 2.5 pocházejí aliasy z aliases.conf. Takže můžete vybrat databázi, ke které se ještě nikdo nepřipojil. Seznam vynechává pracovní soubory cyklu backup-restore (názvy s 4replace v poslední příponě, například employee.fdb.orig4replace_1). Když nic neodpovídá, seznam říká no database matches nebo no databases seen yet, když agent neposlal žádný seznam databází.

Skupinové formuláře záloh (vbackup, nbackup, nbackup dump) mají Auto-exclude individual backups: databáze, která má vlastní (individuální) job zálohy, je vynechána ze skupinového jobu. Je zapnuto, když job nemá žádnou hodnotu. Ve formulářích nbackup je označeno jantarově, když je vypnuto. Pod maskami include a exclude formulář říká, proti čemu se maska porovnává, a co znamená prázdný seznam include pro daný job.

Skupinové formuláře vbackup a nbackup mají políčko Repeat the source folder tree. Zálohy databáze pak jdou do složky pod kořenem záloh, která opakuje její složku pod zdrojovou složkou, například x/y/EMPLOYEE.FDB/. Formuláře nbackup mají políčko pro naming.noPrefix (Individual naming no prefix, Group naming no prefix): úrovně jsou pojmenovány pouze svým datem a časem, jak to dělal FBDataGuard, bez bck_ a názvu databáze. Import z FBDataGuard zapne obojí.

Skupinové formuláře nbackup a dump mají tyto seznamy:

Pole Hodnoty
Order Smallest database first (sizeAsc), Largest database first (sizeDesc), By file path (path). Stará hodnota lastBackupAge se zobrazuje jako lastBackupAge - works as sizeAsc.
Connection checks auto - check when the database attaches, skip - no checks, require - no backup when a check fails.

Skupinové formuláře vbackup a nbackup mají Orphan policy: keepDays - keep for the days below, keepForever - keep a deleteImmediately - move aside at once. Orphan keep (days) je zešedlé, pokud politika není keepDays. Ve skupinovém formuláři vbackup je Connection checks textové pole označené to be implemented: skupinový job vbackup jej nečte. Skupinový formulář vbackup nenabízí Order, Continue on error, Skip database if locked a Fair round robin, protože skupinový job vbackup je ignoruje. Konfigurace, která je má, si je zachová.

Ve formulářích nbackup je Backup level this cron fires seznam: 0 - full, 1, 2, 3, 4. Počty keep stojí vedle plánu každé úrovně, s Add a job for level N. Pokročilý skupinový job ukazuje všech pět úrovní. Compression level a přípona komprimovaného souboru se zobrazují jen tehdy, když je formát Deflate.

Schedule mode jobu nbackup: jednoduchý plán, pokročilý cron pro každou úroveň, nebo Plan (rules for all levels). Nový job začíná v režimu plan. Viz nbackup plan mode.

Každý seznam začíná (default): pak job nemá žádnou hodnotu a agent použije svou výchozí.

Compression. Job zálohy má seznam Compress backups (nebo Compress backup) s těmito hodnotami v tomto pořadí: No compression, Zip, gz, zstd, Deflate. Job bez formátu používá Deflate. Zip, gz a zstd potřebují fbagent 2.75.0 nebo novější; starší agent volbu ignoruje a použije Deflate. zstd je rychlejší a menší než Deflate. Pro otevření souboru zstd použijte zstd -d nebo 7-Zip 24 nebo novější.

Compression level funguje jen pro Deflate. Pro ostatní formáty je zešedlé. Jeho hodnoty: Default (1, fastest), 1 - fastest, 2 až 5, 6 - as before 2.6, 7, 8, 9 - smallest file. Uložená 0 se zobrazuje jako Default. Uložená úroveň nad 9 se zobrazuje s (legacy), dokud nevyberete jinou.

Backup name. Když je název zálohy prázdný, pole zobrazuje výchozí název jako nápovědu a job dostane výchozí hodnotu agenta, na kterém běží.

Test restore. Job zálohy s Check test restore ukazuje pod polem, kde bude vytvořena testovací databáze. Holý název souboru, například test.fdb, jde do složky zálohy. Last outcome jobu pak má řádek Test restore: výsledek (ok, failed, skipped, not run), příkaz gbak restore s Copy, návratový kód, dobu trvání, chybu a zdrojové a cílové soubory (fbagent 2.85.0 nebo novější). Login říká, který login test restore použil: owner (vlastník databáze z Database access),

security database … nebo job login.

Nový úloha vbackup (individuální nebo skupinová) vytvořená pomocí + Add job dostane -rep ve svých možnostech obnovy. Poté gbak přepíše testovací databázi, kterou zanechal předchozí běh. Existující úlohy si své možnosti ponechají.

Commands a Test restore bands. Pás Commands úlohy zobrazuje dva nejnovější příkazy, které agent spustil. Show more zobrazí až 50. Pás Test restore zobrazuje dvě nejnovější testovací obnovy, každou s jejím příkazem zálohy a obnovy. Will be created zobrazuje skutečnou složku testovací obnovy agenta.

Možnosti, které agent odmítá. Agent odmítá úlohu vbackup s volbou gbak -Y a úlohu s -SE a streamem do S3. Také odmítá přihlašovací volby -user, -password, -fetch_password a -trusted: agent nastavuje přihlášení sám (nastavte vlastníka v Database access). Agent s konfiguračním schématem 34 také odmítá -ST: sám přidává -ST TDRW do každého běhu gbak a čte z něj časy zálohy a obnovy. Formulář takovou volbu označí. Pro agenta 2.99.0 nebo novější:

  • Nová úloha vbackup nebo nbackup s takovým nastavením se uloží s vypnutým Enabled. Zpráva po uložení pojmenuje úlohu a důvod. Starší agent odmítl celý soubor.
  • Úloha, která je enabled v živém souboru, se nevypne: uložení je zablokováno. Nejprve opravte nastavení.
  • Záložka Problems zobrazuje takovou úlohu jantarově a Run now je pro ni vypnuto, s důvodem v jejím tooltipu.

Prázdné nebo opakované id úlohy také blokuje Save.

Šifrování zálohy. Individuální a skupinové formuláře vbackup mají Encrypt (AES-256) se seznamem klíčů. Funguje pouze s formátem Zip. Klíče vytváříte na záložce Settings (viz Settings tab). Agent starší než 2.94.2 nemá backup_encryption: přepínač je vypnutý a jeho tooltip říká proč.

Servisní soubory. Pod id úlohy zobrazuje úloha zálohy Service files: <folder>: kde agent uchovává stav úlohy, reporty, logy a journal (fbagent 2.88.0 nebo novější). Id uložené úlohy je pouze pro čtení, protože složka je pojmenována podle něj: nové id by byla nová úloha bez historie.

Smazané úlohy. Když smažete úlohu a přidáte novou na stejné místo, nová úloha nezobrazuje poslední výsledek ani příkazy smazané úlohy. Editor také nikdy nepřidělí nové úloze id smazané úlohy, jejíž historii agent stále uchovává (30 dní).

Formulář cyklu záloha-obnova

Cyklus záloha-obnova vytvoří zálohu databáze, obnoví ji vedle databáze a poté nahradí živou databázi obnovenou kopií. Pracuje ve složce databáze a před výměnou vždy vypne databázi pomocí full.

A new backup-restore cycle job, just added with + Add job
A new backup-restore cycle job, just added with + Add job

Obrázek ukazuje novou úlohu hned po + Add job. Nic ještě není uloženo: záhlaví zobrazuje štítek UNSAVED CHANGES · 2.

Co vidíte

  1. Řádek úlohy: id úlohy (zde restore-replace_cycle-1), Hide settings ▴, Delete, Run now, 2 required empty a štítek plánu 0 0 2 * * 6 s dalším během (“next run 11-21 02:00, sampled by the restore tick”).
  2. Pole Schedule (cron) se šesti cron poli a poznámkou o časovém pásmu.
  3. Poznámka o ticku. Ukazuje, kdy tick úlohy není každou minutu. Zde tick restore běží 0 */5 * * * *, takže cron úlohy může spustit pouze tehdy, když tick běží. Set tick to every minute změní tick úlohy restore na 0 */1 * * * * v editoru. Uložte změnu, abyste ji odeslali agentovi.
  4. Expand all a Collapse all.
  5. Horní pole: Database to rebuild (povinné), Enabled (runs on its schedule; empty = Saturday 02:00) a Allow replace — refuses when the target exists unless set, s poznámkou o plánu.
  6. Skupiny Working folders, Execute before backup, Backup and restore legs a Execute after restore. Skupina s prázdnými povinnými poli má červený rámec a červený počet vedle svého názvu.

Skupiny:

Skupina Pole
Working folders Backup folder: kam jde soubor zálohy. Povinné, pokud režim zálohy není pipe. Originals kept beside the database (each about the database’s size): seznam od 1 do 10. (default) je výchozí hodnota agenta, 1.
Execute before backup Příkaz, který se spustí před zálohou, jeho parametry (jeden na řádek), timeout a zda cyklus pokračuje, když selže.
Backup and restore legs Backup mode — pipe restores without an intermediate file: (default), file nebo pipe. Additional backup options a Additional restore options: volby gbak na jednom řádku, jako na příkazovém řádku, například -p 16384 -bu 2048. Job timeout (seconds).
Execute after restore Příkaz, který se spustí po obnově.
Shutdown (pod More settings) Shutdown grace (gfix -force seconds, default 120).
Disk space preflight (pod More settings) Minimum free space (bytes) a Require free space as a factor of DB size.
Shared with the other restore kinds (pod More settings) Pole úloh obnovy, která cyklus nepotřebuje: Source path (a cycle backs the target up itself), id zdrojové úlohy a Restore mode (the cycle always swaps).
Identity (pod More settings) Kind (must match its array): pouze pro čtení. Id úlohy.

Pole Additional backup options a Additional restore options jsou jeden řádek textu pro agenta s konfiguračním schématem 30 nebo novějším. Pro staršího agenta je editor ukládá jako seznam, protože tento agent čte pouze seznam.

Plán cyklu. Úloha cyklu běží podle svého vlastního plánu, ne při každém ticku úlohy restore:

  • + Add job zapíše 0 0 2 * * 6 (sobota 02:00) do nové úlohy a úloha se spustí vypnutá.
  • Prázdný plán také znamená sobotu 02:00 pro fbagent 2.86.0 nebo novější. Řádek úlohy pak zobrazuje DEFAULT s tímto cronem.
  • Agent starší než 2.86.0 spouští cyklus s prázdným plánem při každém ticku restore (každých 5 minut) a každý běh nahradí živou databázi. Pro takového agenta vždy zapište do úlohy plán.
  • Nejbezpečnější způsob je ponechat úlohu vypnutou a spustit ji pomocí Run now. Vynucený běh funguje i tehdy, když je úloha nebo její sekce vypnutá.

Režim plánu nbackup

V režimu plánu jedna úloha nbackup obsahuje pravidla všech svých úrovní. Mají jej individuální i skupinové formuláře inkrementální zálohy. Úloha plánu potřebuje fbagent 2.98.0 nebo novější: editor ji pro staršího agenta neuloží.

A new nbackup job in plan mode: presets and rules
A new nbackup job in plan mode: presets and rules

Co vidíte

  1. Poznámka: časy spuštění jsou v agent.timezone, s jejím offsetem jako číslem, například “Europe/Moscow — UTC+03:00”, a čas ve vašem prohlížeči.
  2. Start from a preset: Weekly full, Monthly full, Full every 2 weeks, Small database. Předvolba vyplní pravidla.
  3. Jeden rámeček pro každé pravidlo:
    • Level: Level 0 (full), Level 1 až Level 4.
    • When: every day, days of the week, Nth weekday of the month nebo days of the month, s dny a How often (každý týden až každé 4 týdny).
    • At: čas spuštění ve 24hodinovém formátu (HH:MM), v každém prohlížeči. + přidá druhý čas. Repeat místo toho nabízí from, to a every N min.
    • Skip if not started within N min: okno spuštění. Běh, který se v něm nemůže spustit, je přeskočen.
    • × odstraní pravidlo.
    • Řádek pod rámečkem říká pravidlo slovy, například “Level 1: every Monday … at 23:00. If it cannot start by 00:00, it is skipped.”
  4. Add level N a Add another time rule.
  5. Options: Run a full backup when the last one is older than N days (prázdné nebo 0 je vypnuto) a If an increment grows to N % of the full backup, run the lower level instead (10 až 100; prázdné je vypnuto).

Retention může uchovávat celé cykly: zálohu úrovně 0 s jejími přírůstky.

Preview. Pod možnostmi náhled zobrazuje, kdy plán běží.

The plan preview: calendar, one day and the next runs
The plan preview: calendar, one day and the next runs
  • Assume a full backup takes … and each increment …: jak dlouho běhy trvají. Náhled předpokládá, že této úloze neblokuje žádná jiná úloha zálohy.
  • Show 4 až 12 týdnů, s Earlier a Later. Kalendář zobrazuje ve výchozím nastavení 6 týdnů. Každý den zobrazuje své běhy, například L1 nebo L2 x13. new cycle označuje den zálohy úrovně 0.
  • Klikněte na den a zobrazí se jeho běhy na 24hodinové ose a v seznamu, s důvodem každého běhu, například “runs on time” nebo “skipped - level 0 was running”.
  • Next runs: další běhy s jejich úrovní a důvodem.
  • V části retention, když uchováváte počet cyklů, řádek zobrazuje Expected disk use (dokud neproběhnou první zálohy, je neznámé). Rámeček Now on disk zobrazuje zálohy, které jsou právě na disku.

Účty pouze pro čtení mohou také používat náhled kalendáře.

Přepínače agenta

Některé přepínače rozhodují, co agent měří. Jsou v polích sekce jejich řádku na záložce Jobs: otevřete řádek a klikněte na tlačítko sekce. Všechny tři jsou ve výchozím nastavení zapnuté.

Přepínač Řádek a klíč Co dělá
CPU and memory by program Host CPU / RAM, system_metrics.programs Přidává CPU a paměť Firebird, agenta a nejvytíženějších dalších programů do každého záznamu CPU a paměti hostitele. Z hostitele odcházejí pouze názvy, žádné příkazové řádky ani uživatelé.
Memory by service Host CPU / RAM, system_metrics.memory_by_service Přidává, kdo drží RAM: na Linuxu služby (paměť cgroup v2), na Windows programy, a cache, kernel, swap a commit hostitele. Na Linuxu také říká, kolik z každého připojeného databázového souboru drží cache OS.
Disk IO by service Disk IO, disk_io.by_service Rozděluje bajty každého měřeného disku podle služby: Firebird, agent a nejvytíženější ostatní. Linux vyžaduje zapnuté IO accounting (cgroup v2 io.stat). Windows používá relaci ETW.

Tlačítko sekce se zobrazí pouze tehdy, když konfigurace tuto sekci má. Tyto přepínače napájejí karty CPU usage details, Who uses memory a Who uses the disk na dashboard.

Záložka Settings

The configuration editor: Settings tab
The configuration editor: Settings tab

Co vidíte

  1. Levý seznam se všemi sekcemi konfigurace: Firebird, Security.fdb/Users, FBAgent, Local API, Logging, Log rotation, Resource guard, Task telemetry, Config snapshot, Storage & retention, File transfer, Backup encryption keys, Control Center, Trace pipeline, Server status, HQbird import, Prometheus export, License, Run now, Client versions a Managed products.
  2. Pod seznamem: catalog · schema, verze konfigurace, kterou editor zná (například catalog v1 · schema 34).
  3. Vpravo: pole vybrané sekce pod jejím názvem a klíčem (například Firebird firebird.*).

Jak pole fungují:

  • Každé pole zobrazuje svůj název a v případě potřeby nápovědu pod ním.
  • Najeďte ukazatelem na název a zobrazí se popisek. Ukazatel myši se změní na ukazatel nápovědy (šipka s otazníkem) tam, kde je popisek. Popisek začíná tím, co pole dělá. Následuje poznámka, výchozí hodnota a nakonec klíč v souboru, například firebird.install_path.
  • Pole s pevnou sadou hodnot je seznam. První položka je (default), následovaná výchozí hodnotou, pokud ji editor zná. Uložená hodnota, která v seznamu není, zůstane tak, jak je.
  • Řádek s { … } je skupina polí. Řádek s [n] … je seznam s n položkami. Kliknutím na řádek jej otevřete.
  • Šedá pole jsou jen pro čtení. Vyplňuje je agent, například Version.
  • Pole označená base64 obsahují heslo ve formátu base64, tak jak je agent čte. Zadejte heslo v prostém textu; editor jej převede (viz Passwords).
  • V File transfer zobrazuje každý cíl pouze pole, která má. Seznam Add field… pod cílem nabízí pole, která ještě nemá, například checksum_mode, sse a sse_kms_key_id. Vybrané pole začíná na své výchozí hodnotě, nebo prázdné, pokud výchozí hodnotu nemá.

Backup encryption keys obsahuje klíče pro šifrované záložní archivy (viz Backup encryption v části Job forms).

  • Můžete tam vygenerovat nový klíč. Jeho heslo se zobrazí jednou: zkopírujte je a uložte na bezpečné místo. Bez něj zálohy nelze otevřít.
  • escrow_public_key: veřejný klíč pro kopii klíčů (escrow). Snímek s escrow nabízí Download escrow.

Resource guard: výchozí prahová hodnota CPU je 30 (schéma konfigurace 33).

Managed products také ukazuje, jak často zdravý agent kontroluje nové vydání fbagent, HQ Monitor, fbmcp a Firebird a jak často kontroluje připravený uzel nebo RCM, který ještě není nainstalován.

Sekce Server status obsahuje limity pro nálezy stavu serveru. Dva z nich jsou pro Firebird memory pressure: server_status.thresholds.firebird_memory_pressure_pct.warning (10) a .serious (25). Hodnota je podíl času, po který Firebird čekal na paměť za posledních 10 minut, v procentech (Linux PSI služby Firebird). Při dosažení nebo překročení hodnoty je stav warning nebo serious. Bez PSI to agent neposuzuje.

HQbird import má další dvě pole pro import z FBDataGuard: Register databases přidá databáze registrované ve FBDataGuard do databases.conf a Clean old monitoring logs odstraní staré monitorovací logy FBDataGuard. Obě jsou ve výchozím nastavení zapnuté. Agent starší než fbagent 3.4.0 je ignoruje.

Security.fdb/Users

Bezpečnostní databáze serveru a jejich uživatelé mají vlastní položku v levém seznamu: Security.fdb/Users. Sekce Firebird na ni obsahuje odkaz: “Security databases and their users are edited on their own page: Security.fdb/Users”. V demo režimu je slovo “Security” také maskováno, takže obrázky na jeho místě zobrazují vymyšlené slovo.

Settings: Security.fdb/Users with a security database and its users
Settings: Security.fdb/Users with a security database and its users

Co vidíte

  1. Vlevo vedle seznamu sekcí: seznam bezpečnostních databází. Každá položka zobrazuje své id, svůj druh (default, private nebo self), soubor a počet uživatelů, například users: 3. Značky označují problém: no login, refresh failed nebo stale.
  2. Vpravo: pole vybrané položky: auth plugin, Credentials { … }, ID, kind, path a probe databáze.
  3. Seznam uživatelů s Filter by name, Refresh from server, Create user a řádkem s počtem, například 3 of 3 users · refreshed ….
  4. Pod seznamem: čas a chyba posledního obnovení.

Položka default je vlastní bezpečnostní databáze serveru. Její Credentials jsou přihlášení, které agent používá pro server. Když jsou prázdné, agent použije výchozí hodnoty Firebird (SYSDBA a masterkey). Soukromá bezpečnostní databáze nebo databáze, která ověřuje svá vlastní přihlášení, dostane vlastní položku.

  • ID, kind a path vyplňuje agent z databases.conf.
  • Users vypisuje uživatele dané bezpečnostní databáze, 50 na stránku. Filter by name najde uživatele. Řádek nad seznamem říká, kolik uživatelů je zobrazeno a kdy byl seznam načten, například 3 of 3 users · refreshed …. Pole users refreshed at a users refresh error zobrazují čas a chybu posledního obnovení. Uživatel může mít značky admin, inactive, missing on the server a password stored.
  • Refresh from server načte seznam znovu. V lokálním režimu jej agent načte okamžitě a stránka zobrazí nový seznam. Ve vzdáleném režimu tlačítko odešle požadavek Run now úlohy agenta refresh_security_users a nový seznam dorazí s dalším snímkem konfigurace agenta. To vyžaduje fbagent 2.79.0 nebo novější a příslušné oprávnění May run jobs on agents. Na starším agentovi je tlačítko zašedlé a jeho popisek říká proč.
  • Create user vytvoří uživatele v této bezpečnostní databázi pomocí CREATE USER. Agent spustí příkaz s přihlášením této položky. Formulář Create user in … má User name, Password a Repeat the password, User manager plugin (z UserManager v firebird.conf; první je výchozí pro server), First name, Middle name, Last name, Active (the user can log in) a Grant the admin role (GRANT ADMIN ROLE). Admin role vyžaduje druhé potvrzení. Formulář zobrazuje příkaz, který agent spustí. Create jej spustí, Cancel zavře formulář. Agent uloží nové heslo do své konfigurace, takže se později může přihlásit jako tento uživatel.
  • Create user funguje pouze tehdy, když HQ Monitor běží vedle agenta (lokální režim), s agentem novějším než fbagent 2.99.0. Pro vzdáleného agenta je tlačítko zašedlé: “Create user needs local access to the agent. It is not available for a remote agent.” Je také vypnuté, dokud má stránka neuložené úpravy, nebo když položka ještě nemá přihlášení. Najeďte na něj a uvidíte proč.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No users yet: enter the credentials of this security database and refresh from the server. Seznam je prázdný. Nastavte přihlašovací údaje a poté klikněte na Refresh from server.
No user matches the filter. Žádné uživatelské jméno neobsahuje text filtru.
Refreshing reloads the configuration from the agent and discards the unsaved edits on this page. Continue? Máte neuložené změny. Nejprve je uložte, jinak se ztratí.
User list refreshed from the server. Lokální režim: nový seznam je na stránce.
Refresh requested on the remote agent; the list updates when the agent sends its next configuration snapshot. Vzdálený režim: počkejte na další snímek.
Users refresh failed: … Agent nemohl načíst uživatele. Text uvádí důvod.
Refresh from server is not available for this remote agent: … Vzdálené obnovení pro tohoto agenta nefunguje, například protože je příliš starý.
User … created. Create user proběhlo úspěšně. Seznam zobrazuje nového uživatele.
User … already exists in this security database. Zvolte jiné jméno.
The login of this entry may not create users. Credentials položky nemají právo vytvářet uživatele.
Creating users needs Firebird 3.0 or later. Firebird 2.5 zde nemá CREATE USER.
Create user failed: … Agent nemohl uživatele vytvořit. Text uvádí důvod.

Záložka Problems

The configuration editor: Problems tab
The configuration editor: Problems tab

Editor kontroluje konfiguraci a vypisuje, co se zdá být špatně.

Co vidíte

  1. Jedna karta na problém: úroveň (RED, AMBER nebo INFO), název a vysvětlení.
  2. Tlačítko, které problém opraví, například Enable both, Disable both, Remove pattern nebo Set tick to ….

Číslo na záložce Problems počítá červené a oranžové problémy; info se nepočítá. Oprava mění pouze editor. Změnu uložte jako obvykle.

Některé problémy, které vyžadují pozornost:

Problém Co znamená
Backup jobs share one folder and name: … Dvě zapnuté záložní úlohy zapisují zálohy se stejným názvem do stejné složky, takže jejich soubory nelze rozlišit. Když obě úlohy zálohují stejnou databázi, retence každé úlohy maže zálohy druhé úlohy. Karty úloh označují pole složky a názvu. Dejte každé úloze vlastní složku nebo název.
nbackup level without level 0: … Úloha nbackup úrovně 1 nebo vyšší potřebuje úlohu úrovně 0 nebo simple pro stejnou databázi a složku. Agent tuto úlohu nespustí, dokud nějaká nebude.
… section flag and task disagree Jeden přepínač úlohy je zapnutý a druhý vypnutý. Enable both nebo Disable both to opraví.
Restore config job “…” runs on every tick Úloha obnovení bez vlastního plánu běží při každém tiku své úlohy. Dejte jí plán, nebo ji nechte vypnutou a použijte Run now.
Ignore pattern looks too broad: “…” Vzor v server_status.firebird_log.ignore_patterns je tak krátký (například samotné číslice), že odpovídá i jiným řádkům firebird.log. Remove pattern jej odstraní.
… is incomplete Povinná pole jsou prázdná. Při uložení editor úlohu vypne.

Když konfigurace nemá žádné problémy, záložka říká No problems detected in this configuration.

Ukládání: lokální režim (konzole vedle agenta)

Konzole otevírá živý agent_config.json agenta.

  • Save zapíše změnu do souboru, který agent přečte při své další kontrole.
  • Save and apply now uloží a řekne běžícímu agentovi, aby znovu načetl hned. Tlačítko se objeví pouze tehdy, když agent odpovídá; pak je to hlavní (modré) tlačítko na pravém konci. Zpráva Applied live zůstane na stránce po uložení.

Ukládání: vzdálený režim (sběrné centrum)

Konzole otevírá nejnovější snímek konfigurace, který agent odeslal.

  • Save as draft ponechá změnu na konzoli. Agentovi se nic neodesílá. Tlačítko je zašedlé, dokud není co uložit.
  • Open vypisuje konfiguraci agenta a vaše koncepty s jejich stavem: not sent, sent, applied nebo superseded. Řádek nad editorem říká stav otevřeného konceptu.
  • Save and Send to agent odešle změnu agentovi přes goafts. Tlačítko se objeví pouze tehdy, když administrátor zapnul doručování a váš účet má oprávnění May push configuration to agents. Agent použije změnu přibližně za minutu.

Koncepty starší než 30 dní se smažou, když už nevycházejí z aktuálního snímku.

Stav doručení

Po odeslání změny se její stav objeví v editoru a ve sloupci Server/Agent version/Remote control na stránce Servers.

Delivery status
Stav Význam
SENT Změna je uložena na goafts.
TAKEN Agent ji stáhl.
APPLIED Agent ji aplikoval.
ALREADY SET Agent již tyto hodnoty měl.
RESTART NEEDED Aplikováno, ale některé sekce fungují až po restartu agenta. Tooltip je vypisuje.
REJECTED Agent změnu odmítl. Tooltip zobrazuje důvod agenta.
SUPERSEDED Tuto změnu nahradila novější změna.
DRIFT nn′ Žádná odpověď od agenta po dobu nn minut (ve výchozím nastavení 10). Zkontrolujte, zda agent běží.
NOT READ Konzole nemohla přečíst stav.
HQCenter link is not set Doručování je na této konzoli vypnuto.

Hesla

Heslo zadejte v prostém textu. Způsob, jakým jej editor uloží, závisí na režimu:

  • Lokální režim: editor zapíše heslo zakódované v base64 do agent_config.json, protože agent jej v této podobě čte.
  • Vzdálený režim: snímek zobrazuje uložená hesla skrytá. Heslo, které zadáte, se odešle agentovi spolu se změnou a agent jej uloží ve své vlastní chráněné podobě.

Když heslo zadáte přes prosté http, editor zobrazí varování, že spojení není šifrované. Správce to může zakázat; pak pole pro heslo fungují pouze přes https.

Každé uložení, odeslání, změna hesla a spuštění úlohy se zapíše do auditního logu s vaším přihlašovacím jménem.

Spustit nyní

Každý řádek úlohy na kartě Jobs má tlačítko Spustit nyní. Spustí danou úlohu jednou, jakmile to agent bude moci. Rozvrh se nemění. Tlačítko mají zálohy, obnovy, sweepy, přepočet indexů a kontroly gfix.

  1. Klikněte na Spustit nyní na řádku úlohy.
  2. Zaškrtněte políčko Database v horní části dialogu. Zobrazuje, co se spustí: cestu k databázi u jedné úlohy, cíl a zálohu u obnovy, nebo u skupinové úlohy její složku a Databases ticked: N of M.
  3. Zkontrolujte varování. Pokud je úloha, její sekce nebo její úloha plánovače vypnutá, úloha přesto jednou proběhne a poté zůstane vypnutá.
  4. Nastavte možnosti, pokud je úloha má: sweep může respektovat své okno spuštění a inkrementální záloha má úroveň. Skupinová úloha vypisuje své databáze se zaškrtávacími políčky, všechna nejprve zaškrtnutá, s tlačítky Tick all a Untick all. Pokud není zaškrtnuta žádná databáze, je tlačítko pro spuštění vypnuté. Pokud chcete, přidejte důvod.
  5. Klikněte na Spustit nyní. Zavřít dialog zavře a nic nespustí.
The Run now dialog of a vbackup job
Dialog Spustit nyní úlohy vbackup

Ihned po uložení nové úlohy čeká Spustit nyní na to, až agent převezme novou konfiguraci, a poté úlohu spustí.

Řádek úlohy pak zobrazuje stav spuštění:

Run now
  • waiting zobrazuje důvod, například že databáze je zamčená jinou úlohou, že úloha čeká na své okno spuštění nebo že není dostatek volného místa na disku.
  • Klikněte na Cancel run, dokud je spuštění ve stavu queued nebo waiting. Spuštění, které již začalo, nelze zrušit.
  • Úloha, která nahrazuje živou databázi (obnova v režimu nahrazení nebo cyklus záloha-obnova), vyžaduje před aktivací tlačítka zadání názvu souboru databáze. Pokud úloha neuvádí žádnou databázi, zadejte id úlohy.

V lokálním režimu konzole spustí úlohu prostřednictvím agenta na stejném stroji. Ve vzdáleném režimu jde požadavek přes goafts a agent jej převezme při své příští synchronizaci, přibližně do jedné minuty. Tlačítko je neaktivní, když nemůže fungovat, a tooltip uvádí proč:

  • Váš účet nemá právo May run jobs on agents. Úloha, která nahrazuje databázi, navíc vyžaduje May run jobs that replace a database.
  • Vzdálený režim vyžaduje nastavení doručování a users_mode=multiple.
  • Agent vypnul vzdálené příkazy. Toto je nastavení na hostiteli agenta (goafts.remote_commands.enabled; allow_destructive pro úlohy, které nahrazují databázi). Nelze je změnit z konzole.
  • Agent je příliš starý. Vyžaduje fbagent 2.61.0 nebo novější.

Logy úloh

Úlohy zálohování a obnovy uchovávají log gbak z každého spuštění. Když spuštění selže, řádek úlohy zobrazí poslední řádky logu kroku, který selhal. Details na řádku úlohy vypisuje logy posledního spuštění, jeden na krok, s tlačítkem Download log. Na sběrném centru log dorazí s daty agenta, obvykle do 5 minut od spuštění.

Zálohy

Backups zobrazuje inventář záloh serveru: každý záložní soubor, o kterém agent ví, a testovací obnovy a úlohy obnovy.

The Backups page
Stránka Backups

Co vidíte

  1. Záhlaví konzole s označením Backups a drobečkovou navigací Servers › SRV › Backups.
  2. Řádek záhlaví: backups updated …, restores updated … (pouze když agent odeslal data o obnovách) a verze agenta. Na úzké obrazovce se řádek zalamuje.
  3. Řádek s poznámkou (ve vzdáleném režimu). Na obrázku také uvádí, že soubor tabulky Restores nedorazil s logy.
  4. Tabulka Backups s filtry Family:, Database: a Status: a počtem řádků, například 2 of 2.
  5. Tabulka Restores s filtry Kind: a Outcome: a jejím počtem, například 15 of 15. Prázdná tabulka zobrazuje pouze zprávu, jako na obrázku.

Kliknutím na záhlaví sloupce seřadíte. Druhé kliknutí změní směr. Tabulka Backups je zpočátku seřazena podle Created, tabulka Restores podle Finished, nejnovější první.

Tabulka Backups

Sloupec Co zobrazuje
Status OK, MISSING, ORPHANED nebo UNATTRIBUTED (viz níže).
Family Typ úlohy zálohování, například vbackup, a individual nebo group. — pro soubor, který nezaznamenala žádná úloha. ⚠ nbackup copyType označuje dump úlohu, která vytvořila soubor nbackup.
Database Databáze zálohy, například /data/employee.fdb. — když soubor nepatří žádné databázi tohoto serveru.
File Název souboru s tlačítky Copy (zkopíruje úplnou cestu) a More (zobrazí Full path). « Less jej zavře. Najeďte na název a zobrazí se úplná cesta.
Kind Druh souboru: fbk, nbk, nbackupcopy a další.
Size Velikost souboru.
Created Kdy byla záloha vytvořena a jak dávno.
Verified ✔ PASS nebo ✖ FAIL a čas poslední testovací obnovy souboru. Řádek pod tím zobrazuje velikost databáze, kterou obnova vytvořila, a jak dlouho gbak běžel, například 48.0 MB · 35 s. — NEVER, když soubor nezkontrolovala žádná testovací obnova.
Stav Význam
OK Úloha zálohování zaznamenala soubor a ten je na disku nebo ve vzdáleném úložišti.
MISSING Úloha zálohování zaznamenala soubor, ale ten není na disku.
ORPHANED Skenování našlo soubor pro databázi tohoto serveru, ale nezaznamenala jej žádná úloha zálohování.
UNATTRIBUTED Skenování našlo soubor, který nepatří žádné databázi tohoto serveru, například soubor jiného serveru ve sdílené složce.

⚠ nbackup copyType: dump úloha s typem kopie nbackup resetuje inkrementální základnu každé skutečné úlohy nbackup stejné databáze. Použijte lock_nbackup nebo lock_sql.

Tabulka Restores

Sloupec Co zobrazuje
Outcome OK, FAILED nebo SKIPPED.
Kind test (testovací obnova) nebo replace (obnova, která nahrazuje databázi).
Family Typ úlohy, která obnovu provedla, například vbackup.
Job Id úlohy.
Source Záložní soubor s tlačítky Copy a More. More zobrazuje příkaz s tlačítkem Copy, návratový kód, dobu trvání (Took), databázi, cíl, důvod přeskočení a soubory Output log a Error log.
Target Soubor, který obnova vytvořila.
DB size Velikost databáze, kterou obnova vytvořila. — u neúspěšné nebo přeskočené obnovy a u staršího agenta, který velikost neodesílá.
Duration Jak dlouho gbak běžel, podle statistik -ST TDRW v jeho logu. ≈ označuje čas z hodin agenta, od začátku do konce spuštění, když log neobsahuje statistiky.
Trigger on schedule nebo forced run.
Finished Kdy obnova skončila a jak dávno.
Error Chyba nebo důvod přeskočení, například the restore target is a live database nebo not enough free space at the restore path.

Stránka zobrazuje prvních 500 řádků tabulky. Show all N rows zobrazí zbytek. Události obnovy se uchovávají 14 dní.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No backups recorded yet. The inventory fills in as backups run, and fully on the next backup-status reconcile (every 2 hours). Agent zatím nemá ve svém inventáři žádnou zálohu.
No restore events recorded yet. Test restores (vbackup verify) and restore jobs appear here as they run; events are kept for 14 days. Za posledních 14 dní neproběhla žádná obnova.
This inventory is capped and older entries have been dropped, so what is listed is not everything the agent knows about. Seznam má omezení velikosti a nejstarší řádky byly odstraněny.
Not available in this log tree — see the note above. Data agenta pro tuto tabulku nedorazila do konzole. Řádek s poznámkou uvádí proč.
Could not load … Stránka nemohla načíst data. Znovu načtěte stránku.

Tipy:

  • Filtrujte Status: podle orphaned a najděte záložní soubory, které nezaznamenala žádná úloha zálohování, například soubory, které někdo zkopíroval ručně.
  • FAIL ve sloupci Verified znamená, že testovací obnova tohoto souboru selhala. Otevřete More v tabulce Restores a zobrazte příkaz a soubory logu.

Aktivita

Karta Activity zobrazuje, jak probíhaly úlohy plánovače agenta.

The Activity page
Stránka Activity

Co vidíte

  1. Záhlaví konzole s označením Jobs a drobečkovou navigací Servers › SRV › Jobs › Activity.
  2. Složka s daty agenta a řádek s poznámkou (ve vzdáleném režimu).
  3. Karty Jobs, Settings, Problems a Activity.
  4. Scheduler tasks: poznámka o časovém okně a poté počet úloh, například 28 tasks.
  5. Tabulka úloh.

Počítadla pokrývají telemetrické okno agenta, nikoli kalendářní den. Okno pokračuje přes půlnoc a začíná znovu při restartu agenta.

Sloupec Co zobrazuje
Task Úloha plánovače. + otevře seznam jejích spuštění.
Last invocation Kdy úloha naposledy běžela, v čase agenta, a jak dávno.
Invocations Kolikrát běžela v okně.
p95 wall 95 % spuštění trvalo tuto dobu nebo méně.
CPU Čas CPU všech spuštění včetně jejich podřízených procesů.
Max RSS Δ Největší nárůst paměti během jednoho spuštění.
Overlap Kolik dalších úloh běželo současně, v průměru.
Failed Kolik spuštění úlohy selhalo. Najeďte na číslo a zobrazí se poslední chyba. — znamená žádné.

Kliknutím na záhlaví sloupce seřadíte. Tabulka je zpočátku seřazena podle Last invocation, nejnovější první.

+ otevře až 100 nejnovějších spuštění úlohy:

Sloupec Co zobrazuje
Started (agent time) Kdy spuštění začalo.
Wall Jak dlouho spuštění trvalo.
CPU (+child) Čas CPU spuštění a jeho podřízených procesů.

| RSS Δ | Růst paměti během běhu. | | Overlap | Kolik dalších úloh běželo ve stejnou dobu. | | Detail | ruční spuštění u běhu spuštěného ručně, chyba neúspěšného běhu nebo jiné skutečnosti. Neúspěšný běh je červený. |

Failed počítá neúspěšné běhy úlohy plánovače, nikoli výsledky jednotlivých jobů. Úloha seznamu jobů skončí bez chyby, i když každý job pod ní selhal. Výsledky jobů jsou na kartě Jobs.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No agent data tree was found beside this configuration, so there is no activity to read. Konzole nemá pro tento server žádná data agenta.
This log tree carries no task telemetry. The agent writes it from version 2.0.15 onward; an older agent, or log rotation, leaves nothing here. Agent neposlal žádnou telemetrii.
The newest records are older than this agent’s own cadence would produce. On a console that usually means the log pack has not arrived yet, rather than that the scheduler stopped. Data jsou stará. Počkejte na další log pack.
The telemetry files are present but could not be read. Soubory jsou poškozené nebo v neznámém formátu.
No invocations recorded for this task in the window that was read. Úloha v daném okně neběžela.
Reading this task’s invocations… Seznam běhů se načítá.
Showing the newest N invocations; older ones in this window were not read. Zobrazeny jsou pouze nejnovější běhy.
N unreadable line(s) were skipped. Některé řádky telemetrie nebylo možné přečíst.
Could not read … Stránka nemohla data přečíst. Znovu načtěte stránku.

Úloha s velkou hodnotou p95, CPU nebo paměti je první, kterou je třeba zkontrolovat, když agent spotřebovává příliš mnoho prostředků serveru.


10. Licence

Tlačítko Licenses na stránce Servers otevře stránku License (/license). Každý přihlášený uživatel ji může číst, pro servery, které daný uživatel smí vidět. Konzole licence pouze zobrazuje a doručuje licenční soubor. Nikdy nic neblokuje: licenci kontroluje agent a goafts ji ukládá a vydává.

Seznam serverů

The License page
The License page

Co vidíte

  1. Záhlaví s ← Servers a řádek drobečkové navigace Servers › Licenses.
  2. Licenční banner, pouze když některý server vyžaduje pozornost (viz Licenční banner).
  3. Řádek s chybou. Je prázdný, když se stránka načte bez problémů.
  4. Nadpis HQbird licenses s počtem serverů, vyhledávací pole Search servers… a tlačítko Refresh.
  5. Tabulka: jeden řádek pro každý server, který smíte vidět, seřazený podle názvu.
  6. Pod tabulkou: server, na který jste klikli (viz Jeden server).
Sloupec Co zobrazuje
Server Název serveru (agenta).
State Odznak: LICENSED (zelený), GRACE nebo UNLICENSED (jantarový), INVALID (červený), TRIAL nebo NO DATA. Značka ⚠ za odznakem znamená, že poslední hlášení je starší než 3 dny.
Valid until Datum, které je pro tento stav rozhodující: datum vypršení licence, konec období grace, konec fáze 1 nebo zkušební doby, nebo nejzazší konec zkušební doby. Když zbývá 60 dní nebo méně, následuje počet dní, například (12 d). Najeďte na datum a zobrazí se, co znamená.
Kind floating, bound to hosts nebo none.
Customer Zákazník licence.
Enforce yes nebo no: zda agent licenci vynucuje.
At risk Kolik nakonfigurovaných jobů vyžaduje licenci, kterou tento server nemá.
Reported Kdy agent naposledy nahlásil licencování, v místním čase vašeho prohlížeče.

Server bez hlášení zobrazuje v datových sloupcích „—". Najeďte na řádek a zobrazí se krátké shrnutí: důvod stavu, zákazník a id licence a případně „Enforcement is off: nothing is blocked." a „Jobs that need a license: 19".

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No servers. Žádný server neodpovídá hledání, nebo nemáte viditelný žádný server.
⚠ „The last report from the agent is old: the state shown may be out of date." Agent nenahlásil licencování více než 3 dny. Zkontrolujte, že agent běží.

Tipy:

  • Search servers… filtruje tabulku podle názvu serveru. Refresh znovu načte seznam a otevřený server.
  • /license?server=SRV otevře přímo jeden server. Tento odkaz používají licenční banner a buňka License na stránce Clusters.

Jeden server

Klikněte na řádek. Pod tabulkou se otevřou podrobnosti daného serveru.

One server on the License page
One server on the License page

Co vidíte

  1. Název serveru a jeho odznak stavu.
  2. Poznámky, pouze když se uplatní: žádné hlášení od agenta, staré hlášení nebo „Enforcement is off: nothing is blocked. The jobs listed below would stop when it is switched on."
  3. Seznam licenčních polí (tabulka níže).
  4. Features: funkce, které licence uděluje, jako malé štítky.
  5. Seats: místa, která licence uděluje.
  6. Jobs that need a license: joby, které jsou nakonfigurované, ale aktuální stav je nepovoluje. Při vypnutém vynucování stále běží. Seznam ukazuje, co by se zastavilo.
  7. Pod nimi, u zkušební doby: sekce Extend the trial to 30 days (viz Zkušební doba).
  8. Sekce pro instalaci nebo nahrání licence (viz Instalace licence) a seznam Licenses in goafts, pokud jej smíte použít.
Pole Co zobrazuje
State Odznak stavu.
Reason Proč má server tento stav, slovy (viz zprávy níže).
License id, Customer Licence a zákazník, kterému byla vydána.
Expires, Grace ends Datum vypršení a konec období grace.
Kind floating, bound to hosts nebo none.
Trial yes nebo no. U zkušební doby: kdy začala a kdy končí.
Trial stage stage 1 (no email needed), stage 2 (email and code) nebo over. Pouze během zkušební doby.
Stage 1 ends, Trial ends at the latest Data zkušební doby s počtem zbývajících dní. Pouze během zkušební doby.
First license accepted Kdy agent přijal svou první licenci. Pouze když to agent hlásí.
Email request Stav e-mailu zkušební doby: not sent, being checked, code sent by email, code accepted, waiting for the trial license, trial license installed nebo closed s důvodem.
Enforcement yes nebo no.
Mode Režim agenta: full nebo license only.
Install id Identita hostitele. Pro ni se vydává licence vázaná na hostitele.
Last online check Kdy se agent naposledy spojil s licenčním serverem.
Agent Id agenta a jeho verze.
Reported at Kdy agent toto hlášení zapsal.
Sloupec Co zobrazuje
Seat Tabulka Seats: druh místa.
Licensed Tabulka Seats: kolik míst tohoto druhu licence uděluje.
Job Tabulka Jobs that need a license: id jobu.
Feature Tabulka Jobs that need a license: funkce, kterou job vyžaduje.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
The agent of this server has not reported licensing (an older agent, or no report yet). Stav je NO DATA. Aktualizujte agenta nebo počkejte na jeho první hlášení.
no license installed Reason: není nainstalována žádná licence ani zkušební doba.
the license is bound to another host Reason: licence byla vydána pro jiné install id.
the host identity changed: a new activation request is needed Reason: pošlete dodavateli novou žádost o aktivaci.
the agent has not reached the license server in time Reason: online kontrola je opožděná. Zkontrolujte, že hostitel dosáhne na licenční server.
stage 1 of the trial is over: enter a work email to extend the trial to 30 days Reason: viz Zkušební doba.
the trial is over Reason: nainstalujte zakoupenou licenci.
No features granted. / No seats. Licence neuděluje nic tohoto druhu, nebo není žádná licence.
Every configured job is allowed. Žádný job by se nezastavil.
Could not read the license state Konzole nemohla přečíst hlášení tohoto serveru.

Jsou možné i jiné důvody, například „the license file was removed; there is no new trial after a license" nebo „the license is signed with a trial key but is not a valid trial license".

Instalace licence

Sekce pod podrobnostmi serveru instaluje nebo nahrává licenční soubor. Vyberte soubor v poli License file a klikněte na tlačítko. Co se stane, závisí na tom, kde agent běží:

Agent Co tlačítko dělá Kdo jej smí použít
Na stroji této konzole (lokální režim). Nadpis sekce: Install a license in the agent on this machine. Install odešle soubor agentovi. Agent před zápisem čehokoli ověří podpis. Administrátor. V jednouživatelském režimu tento jediný uživatel.
Jinde a konzole je nastavena pro goafts. Nadpis sekce: Upload a license to goafts. Upload uloží soubor do goafts. Poté klikněte na Assign to SRV v seznamu Licenses in goafts nebo na Set as default. Uživatel s právem May push configuration to agents (režim uživatelů multiple). Administrátoři toto právo také potřebují. Výchozí licenci nastavuje pouze administrátor.

Pokud agent nebo goafts soubor odmítne, stránka zobrazí jejich zprávu. Každá instalace, nahrání a přiřazení se zapisuje do auditního souboru, s hashem souboru, nikoli se souborem samotným. Změna v goafts, kterou nelze zapsat do auditního souboru, se neprovede.

Žádost o aktivaci. V lokálním režimu administrátor vidí také Activation request. Stáhne license_request_<server>.json. Pošlete jej dodavateli. Dodavatel k install id v něm naváže licenci. Získanou licenci nainstalujte na stejné stránce. Použijte to pro server, který nemůže dosáhnout na licenční server.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
License accepted Agent nebo goafts soubor přijal.
Choose a license file first. Klikli jste na tlačítko bez vybraného souboru.
The file is over 1 MB: this is not a license. Vybrali jste nesprávný soubor.
This account cannot change licenses here: installing a license needs an administrator account Lokální režim a váš účet není administrátorský. Pole souboru a tlačítko jsou skryté.
This account cannot change licenses here: this console cannot deliver a license to this server: … Agent není na tomto stroji (agent_config_path) a doručení přes goafts není nastaveno. Nainstalujte licenci na daném serveru.
The license is uploaded to goafts and is not tied to SRV: assign it to servers in the list below. Vzdálený režim. Po nahrání přiřaďte licenci v seznamu licencí v goafts.
this agent has no license support: update the agent first (…) Agent je pro licence příliš starý.

Licenses in goafts

Tento seznam zobrazuje licence, které goafts ukládá. Zobrazuje se pouze když je konzole nastavena pro doručování konfigurace (goafts_push_enabled a klíče goafts_admin_*, režim uživatelů multiple) a váš účet je administrátor nebo má právo May push configuration to agents.

Řádek s nadpisem obsahuje Refresh a pro administrátora, když má goafts výchozí licenci, Clear default license.

Sloupec Co zobrazuje
License Id licence. Štítek default označuje výchozí licenci. Štítek assigned here označuje licenci otevřeného serveru. Číslo v závorkách, například (3), ukazuje, kolika agentům je licence přiřazena.

| Zákazník | Zákazník licence. | | Platná do | Datum vypršení platnosti. | | Využitá místa / celkem | Pro každý druh místa: kolik je využito a kolik jich licence má. | | Stav | Odznak stavu licence. | | Akce | Assign to SRV nebo Unassign from SRV pro otevřený server (server, jehož agent je jinde), a Set as default (pouze administrátoři). |

Výchozí licence se vztahuje na každého agenta tohoto goafts, který nemá vlastní licenci.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
No licenses are stored in goafts. Nejprve nahrajte licenci.
Assignments saved goafts uložil změnu.
Make … the default license? It applies to every agent of this goafts that has no license of its own. Potvrďte Set as default.
Clear the default license? Agents with no license of their own will have none. Potvrďte Clear default license.
the default license applies to every agent of goafts; only an administrator may change it Váš účet není administrátor.
this change cannot be recorded in the audit trail, so it was not made: … Konzole nemůže zapsat svůj auditní soubor. Zkontrolujte audit_file.

Zkušební verze

Nový agent spouští zkušební verzi ve dvou fázích:

The trial
  • Fáze 1: prvních 7 dní od prvního spuštění. Není potřeba žádný e-mail.
  • Fáze 2: zadáte pracovní e-mail, zkušební server dodavatele vám pošle kód a vy kód zadáte. Zkušební verze pak trvá 30 dní od prvního spuštění.
  • Po zkušební verzi, bez licence a se zapnutým vynucováním, agent zastaví zálohy, obnovu, sweep, trasování, statistiky a replikaci. Databáze fungují dál.

Podrobnosti serveru zobrazují fázi zkušební verze, konec fáze 1, nejzazší konec zkušební verze (se zbývajícími dny) a stav e-mailového požadavku.

Prodloužení zkušební verze (lokální režim, administrátor). Sekce Extend the trial to 30 days se zobrazuje pro server bez zakoupené licence, který má data zkušební verze.

  1. Zadejte adresu do Work email.
  2. Zaškrtněte políčko souhlasu. Uvádí, kam adresa putuje a jak dlouho je uchovávána.
  3. Klikněte na Send. Stránka zobrazí odpověď zkušebního serveru, nebo “The request is sent.”
  4. Až e-mail dorazí, zadejte šestimístný kód do Code from the email a klikněte na Confirm.

Agent nainstaluje zkušební licenci sám, jakmile ji dodavatel podepíše. Řádek “Request: …” zobrazuje stav požadavku.

Pro server, jehož agent je jinde, stránka zobrazuje pouze zkušební verzi. Zadejte e-mail na tomto serveru, v jeho vlastní konzoli nebo pomocí fbagent --trial-email.

Oba kroky se zapisují do auditního souboru. Auditní řádek e-mailu nese hash adresy, nikoli adresu. Kód se nikdy nezapisuje.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Only an administrator can send the email and the code. Lokální režim a váš účet není administrátor.
This page only shows the trial of this server. To extend it, enter the email on that server: in HQbird Monitor on that machine, or with fbagent –trial-email. Agent není na tomto počítači.
The agent has no trial server set (license.trial_server in agent_config.json), so no email can be sent from here. Nastavte license.trial_server v konfiguraci agenta.
This is not a valid email address. / Tick the consent box first. Opravte formulář a klikněte znovu na Send.
Enter the 6-digit code from the email. Pole pro kód je prázdné.
Wrong code. Attempts left: 2. Kód nesouhlasí. Zkontrolujte e-mail.
The request is closed: … Požadavek skončil, například “too many wrong codes” nebo “this server already had a trial”.
No trial is possible for this server: it already has a license, or 30 days since the first start have passed. Zkušební verzi nelze prodloužit.
The agent cannot reach the trial server. Check that this host can open HTTPS connections to it. Problém se sítí na hostiteli agenta.
The code is accepted. The agent installs the trial license by itself when the vendor has signed it. Počkejte. Stav se změní na trial license installed.
The trial is over. Only a purchased license brings back the stopped work. Nainstalujte zakoupenou licenci.

Licenční banner

Každá stránka zobrazuje pod záhlavím banner pro servery, které můžete vidět:

  • červený: “No license. Backups, restore, sweep, tracing, statistics and replication are stopped. The databases work.” Server nemá licenci a vynucování je zapnuto. Odkaz je License page.
  • žlutý: “Trial: 5 days left. To extend it to 30 days, enter a work email.” Server je ve fázi 1 zkušební verze a zbývá mu 7 dní nebo méně. Odkaz je Enter an email.

Každý řádek končí “Servers: …” a až 3 názvy serverů, poté “and 4 more”, pokud jich je více. U jednoho serveru odkaz otevře tento server na stránce License. U několika serverů otevře seznam. Enter an email přejde na sekci zkušební verze na stránce License a umístí kurzor do pole e-mailu.

Server, jehož poslední hlášení je starší než tři dny, se z banneru vynechá.


11. Administrace: uživatelé, clustery, oznámení a aktualizace

Stránky Users a Clusters jsou pouze pro administrátory. Stránka Servers zobrazuje tlačítko User management pouze administrátorovi v režimu multiple a tlačítko Clusters administrátorovi (viz goafts mode, RCM mode and agent mode pro režim jednoho uživatele). Jiný účet, který tyto stránky otevře, dostane “Forbidden”.

Stránky Notifications a Updates pracují s agentem na tomto počítači. Otevřít je může každý uživatel; měnit tam něco může pouze administrátor.

Uživatelé

Konzole má dva uživatelské režimy. Administrátor nastavuje režim v config.properties (users_mode).

  • single (výchozí): jeden sdílený účet. Jeho heslo je v lokálním agentovi agent_config.json (fbagent 2.80.0 nebo novější) nebo v access.properties. Tento uživatel může dělat vše. Neexistuje správa uživatelů. Heslo se mění na stránce Settings (viz Settings).
  • multiple: několik účtů, každý s vlastním heslem a seznamem serverů. Účty jsou uloženy v users.enc.

V režimu multiple otevřete User management na stránce Servers.

User management
User management

Co uvidíte

  1. Záhlaví s ← Servers a řádek s drobečkovou navigací Servers › Users.
  2. Nadpis Users s počtem uživatelů, vyhledávací pole Search users… a tlačítko Add vpravo.
  3. Tabulku uživatelů.
  4. Řádek stránkování: Previous, “Page 1 of 1”, Next a “Total: 3”.
Sloupec Co zobrazuje
Login Přihlašovací jméno. Kliknutím jej upravíte.
Servers All servers pro administrátora. Pro uživatele: názvy přiřazených serverů, nebo “—”, pokud žádné nejsou.
Actions Delete odstraní uživatele po potvrzení.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Delete user …? Potvrďte smazání.
Failed to delete user: cannot remove last administrator Konzole musí zachovat alespoň jednoho administrátora.
Failed to load users: … Konzole nemůže přečíst users.enc.

Tipy:

  • Vyhledávání najde přihlašovací jména, která obsahují text. Seznam se aktualizuje po krátké pauze a vrátí se na stránku 1.
  • Tabulka zobrazuje 50 uživatelů na stránku.

Přidání nebo úprava uživatele

Add otevře formulář pro nového uživatele:

Add a user
Add a user

Co uvidíte

  1. Záhlaví s ← Servers a odkazem Users a řádek s drobečkovou navigací Servers › Users › Add user.
  2. Nadpis Add user.
  3. Vlevo: Login, Password, Type, tři práva s jejich nápovědou a Save.
  4. Uprostřed: Available servers s vyhledávacím polem Search servers…, tlačítkem Add, zaškrtávacím polem Select all filtered (pouze při vyhledávání) a servery jako “name (id)”.
  5. Vpravo: Assigned servers se zaškrtávacím polem Select all a tlačítkem Remove selected. Pokud nejsou žádné servery, zobrazí “No servers assigned”.
Pole Co dělá
Login Jméno pro přihlášení.
Password Heslo. Na stránce úprav jej ponechte prázdné pro zachování aktuálního hesla (“Leave blank to keep the current password”).
Type User (výchozí) vidí pouze své Assigned servers. Administrator vidí všechny servery a spravuje uživatele a clustery. Pro administrátora jsou panely serverů skryté a formulář zobrazuje “All servers”.
May push configuration to agents “Lets this account send an edited agent_config.json to the agent through goafts, and save and apply the configuration of the agent on this machine (administrators may do that without it).”
May run jobs on agents “Lets this account start and cancel a backup, restore, sweep or index recalculation on an agent from the configuration page. For a remote server it also needs configuration push to be set up.”
May run jobs that replace a database “Also lets this account run a restore that replaces a live database. It works only together with the right to run jobs, and the agent must allow it as well.”

U existujícího účtu jsou všechna práva vypnutá.

Přidání uživatele:

  1. Vyplňte Login a Password.
  2. Zvolte Type.
  3. Zaškrtněte práva, která uživatel potřebuje.
  4. Pro User: najděte servery v Available servers (pište do Search servers…), zaškrtněte je a klikněte na Add. Add je aktivní pouze když je zaškrtnuto nějaké pole. Select all filtered se zobrazuje pouze tehdy, když vyhledávací pole obsahuje text. Zaškrtne každý server, který odpovídá vyhledávání. Servery se přesunou do Assigned servers. Zaškrtněte tam servery a klikněte na Remove selected pro jejich vrácení.
  5. Klikněte na Save. Konzole otevře stránku úprav nového uživatele.

Pro úpravu uživatele klikněte na přihlašovací jméno v seznamu. Stránka úprav má nadpis Edit user a drobečkovou navigaci Servers › Users › <login>.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
User saved Změna je uložena.
Failed to add user: duplicate login Uživatel s tímto přihlašovacím jménem existuje.
Failed to add user: invalid login / invalid password Přihlašovací jméno nebo heslo není povoleno. Použijte jiné.
Failed to add user: maximum user count exceeded Konzole pojme až 2000 uživatelů.
Failed to save user: user not found Někdo tohoto uživatele smazal.
Failed to save user: cannot remove last administrator Pokusili jste se změnit posledního administrátora na User.
No available servers Všechny servery jsou přiřazeny, nebo žádný server neodpovídá vyhledávání.

Kdy se změny projeví:

  • Konzole čte users.enc při každém požadavku. Nový seznam serverů, nový typ nebo nové právo se projeví při příštím načtení stránky uživatelem.
  • Nové heslo odhlásí tohoto uživatele ve všech prohlížečích.
  • V režimu single může jeden sdílený uživatel spouštět úlohy na agentovi vedle konzole, ale ne na vzdáleném agentovi.

Při prvním spuštění v režimu multiple konzole vytvoří administrátora admin7 s náhodným heslem. Heslo se zapíše jednou do logu konzole, nebo, pokud administrátor nastavil initial_admin_password_file, do tohoto souboru a nikoli do logu. Přihlaste se a změňte je.

Clustery

Clusters spravuje replikační skupiny HQCluster: členy,

odkazy replikace a certifikáty členů. Konzole sama clustery neukládá. Upravuje je prostřednictvím admin API goafts nebo RCM nebo prostřednictvím agenta na tomto serveru (viz režim goafts, režim RCM a režim agenta). V lokálním režimu má stránka také sekci Cluster na tomto serveru.

The Clusters page with one cluster open
The Clusters page with one cluster open

Co vidíte

  1. Záhlaví s ← Servery a řádek s drobečkovou navigací Servery › Clustery.
  2. Řádek s chybou. Když je vše v pořádku, je prázdný.
  3. Nadpis Clustery HQCluster s počtem clusterů, pole Nové ID clusteru a tlačítko Vytvořit.
  4. Seznam clusterů. Kliknutím na řádek cluster otevřete.
  5. Otevřený cluster: jeho ID a jeho revize (rev 6), poté nastavení clusteru na jednom řádku.
  6. Členové s tlačítkem Přidat člena a tabulka členů.
  7. Odkazy replikace s tlačítkem Přidat odkaz a tabulka odkazů.
  8. Tlačítka Ověřit, Uložit a Smazat cluster (ne v režimu RCM ani v režimu agenta) a pod nimi seznam chyb a varování.
  9. Stav, Žádosti o certifikát a CA clusteru (viz Stav clusteru a certifikáty).
Sloupec Co zobrazuje
Cluster ID clusteru.
Název Název clusteru.
PKI managed nebo external.
Revize Revize uloženého dokumentu clusteru. S každým uložením roste.
Členové Počet členů.

Nastavení clusteru:

Pole Co nastavuje
Název Název pro lidi.
PKI managed: vlastní CA clusteru podepisuje certifikáty členů a agenti je obnovují. external: certifikáty spravujete sami a agenti je pouze hlásí.
Platnost certifikátu, dny Jak dlouho je certifikát člena platný: 2 až 825 dní. Výchozí 90.
Obnovit před, dny Kolik dní před datem vypršení se certifikát obnoví. Výchozí 30.
Kontrolovat názvy protějšků (pouze spravované certifikáty) Členové kontrolují názvy v certifikátech ostatních.

Tabulka členů:

Sloupec Co zobrazuje
Člen ID člena.
Agent Agent hostitele. Pole při psaní nabízí známé agenty.
Role master, replica nebo rcm.
Adresy Adresy člena oddělené čárkami nebo mezerami, například 192.168.0.10.
Port Port replikace. Nový člen dostane 7051.
Instalační adresář Instalační složka člena.
Akce Re-key (pouze uložení členové) objedná nový klíč a certifikát. Odebrat odebere člena a jeho odkazy replikace.

Po uložení nelze Člen, Agent a Role člena změnit. Chcete-li je změnit, odeberte člena a přidejte ho znovu. Změny v tabulkách členů a odkazů se uloží až po kliknutí na Uložit.

Tabulka odkazů:

Sloupec Co zobrazuje
Master Člen s rolí master.
Replica Člen s rolí replica.
Akce Odebrat odebere odkaz.

Vytvoření nebo změna clusteru:

  1. Zadejte Nové ID clusteru a klikněte na Vytvořit. Nebo klikněte na existující cluster a otevřete ho.
  2. Klikněte na Přidat člena pro každého člena. Vyplňte agenta, roli, adresy a port.
  3. Klikněte na Přidat odkaz pro každý odkaz z masteru na replicu.
  4. Klikněte na Ověřit. Stránka zobrazí „The document is valid.“ nebo seznam chyb (červené) a varování (jantarové).
  5. Klikněte na Uložit.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
A cluster id is lower-case letters, digits and “-”, up to 63 characters. Změňte ID. Nesmí začínat ani končit znakem „-“.
No clusters yet. Vytvořte první cluster.
The document is valid. Ověřit nenašlo žádné problémy.
Seznam červených a jantarových řádků Chyby brání uložení. Varování ne. Odmítnuté Uložit zobrazí své chyby ve stejném seznamu.
Cluster saved Nová revize je uložena.
Someone else changed this cluster. Reload it and make your change again. Jiný administrátor uložil cluster poté, co jste ho otevřeli.
Delete cluster …? It must have no members. Potvrďte Smazat cluster. Nejprve odeberte všechny členy a uložte.
clusters are edited through … admin API, which this console is not set up for: … Nastavení konzole pro clustery je neúplné. Viz Řešení problémů.
this change cannot be recorded in the audit trail, so it was not made: … Každá změna se nejprve zapíše do auditního souboru. Zkontrolujte audit_file.

Stav clusteru a certifikáty

Tyto části se zobrazují pro uložený cluster.

Stav zobrazuje, co hlásí každý člen. Obnovit jej načte znovu. Rotovat CA se zobrazuje pouze pro cluster s managed PKI.

Sloupec Co zobrazuje
Člen ID člena a jeho roli.
Agent Agent člena.
Hlášeno ✓, když člen hlásil, —, když ne.
Revize Revize clusteru, kterou člen použil.
Certifikát do Datum vypršení certifikátu člena. renew due označuje certifikát, který je třeba obnovit.
Služba Stav služby replikace, například running.
Licence Odznak stavu licence agenta a pod ním rozhodné datum, například datum vypršení. Kliknutím otevřete server na stránce Licence.
Poslední chyba Poslední chyba člena.

Žádosti o certifikát zobrazují 20 nejnovějších žádostí, nejnovější první.

Sloupec Co zobrazuje
Žádost ID žádosti.
Člen Člen, který o certifikát požádal.
Důvod Proč byl certifikát vyžádán.
Stav Stav žádosti.
Poslední chyba Proč byla žádost odmítnuta, pokud byla.

CA clusteru uvádí certifikáty CA, kterým členové důvěřují.

Sloupec Co zobrazuje
Otisk Otisk SHA-256 certifikátu CA.
Subjekt Subjekt certifikátu CA. (retired) označuje CA, která se již nepoužívá.
Platný do Datum vypršení certifikátu CA.
Akce Vyřadit odebere CA ze svazku, kterému členové důvěřují.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Rotate the CA of cluster …? Every member gets a new CA bundle and restarts once in its window. Potvrďte Rotovat CA.
Make a new key and certificate for …? Potvrďte Re-key.
Remove this CA from the bundle the members trust? Potvrďte Vyřadit.
Order queued Objednávka je uložena. Členové ji vykonají.

Cluster na tomto serveru

Tato sekce je v horní části stránky Clustery. Zobrazuje se pouze v lokálním režimu (agent_config_path je nastaven) a pouze administrátorovi. Konzole komunikuje s agentem na tomto stroji prostřednictvím jeho Local API. Agent potřebuje trasy clusteru (GET /v1/cluster); u staršího agenta sekce uvádí „The agent on this server is too old for this section. Update fbagent.“

Co vidíte

  1. Stav agenta: Free: not in a cluster, In a cluster nebo Runs the RCM of its own cluster. Poté ID clusteru, zdroj clusteru (rcm, goafts nebo none), důvod, proč je agent v tomto stavu, a varování agenta.
  2. Připravit pro cluster, pouze pro volného agenta: párovací okno, párovací port, otisk certifikátu, zbývající čas, RCM, které může tento server pozvat, a co agent provedl ve firewallu.
  3. Konzole clusteru (RCM): zda je RCM nainstalováno a běží, agent, který je spouští, jeho cluster a jeho složka. Povolit konzoli clusteru (RCM) se zobrazuje pro volného agenta. Otevřít konzoli RCM se zobrazuje, když RCM běží.

Příprava tohoto serveru pro cluster, který spravuje jiné RCM:

  1. Volitelné: do Které RCM může tento server pozvat zadejte adresy, rozsahy nebo názvy hostitelů oddělené čárkami. Ponechte pole prázdné, chcete-li zachovat seznam, který má agent. Zadejte any, aby tento server mohlo pozvat jakékoli RCM.
  2. Klikněte na Otevřít párovací okno na 24 hodin. Dokud je okno otevřené, agent otevře párovací port ve firewallu hostitele.
  3. V konzoli RCM přidejte tento server na stránce Link hosts. Zkontrolujte tam, že port a otisk jsou stejné jako v této sekci.
  4. Klikněte na Zavřít párovací okno, pokud je již nepotřebujete.

Agent, který spouští RCM, nedostane párovací okno: jiné RCM by ho mohlo vzít z jeho vlastního clusteru.

Chcete-li z tohoto serveru udělat konzoli (RCM) nového clusteru:

  1. Volitelné: zadejte Nové ID clusteru. Prázdné: ID se vytvoří z názvu hostitele.
  2. Klikněte na Povolit konzoli clusteru (RCM) a potvrďte. Tlačítko je neaktivní, dokud není program RCM v produktové cache agenta.
  3. Agent vytvoří RCM hostitele. Sekce sleduje průběh. Agent se během této doby může restartovat; stránka na něj čeká až 3 minuty.
  4. Na konci sekce zobrazí ID clusteru, URL konzole (https://<host>:7444/), přihlašovací údaje a soubor na serveru, který obsahuje heslo. Heslo se nikdy nezobrazuje. Pokud již RCM má své přihlašovací údaje, sekce místo toho zobrazí poznámku agenta.

Každá změna se nejprve zapíše do auditní stopy: cluster.pairing.open, cluster.pairing.close, cluster.rcm.enable.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
This server runs the RCM of its cluster, so it cannot open a pairing window: … Agent spouští RCM. Propojte ostatní servery s tímto RCM.
This server is already in a cluster. RCM nelze povolit na serveru v clusteru.
Another agent on this host already runs the RCM. Jedno RCM na hostitele. Použijte konzoli tohoto RCM.
The RCM program is not in the agent’s product cache yet. Aktualizujte produkty agenta a zkuste to znovu.
Another operation of the agent is in progress. … Počkejte, až skončí, a zkuste to znovu.
The agent does not answer. It may be restarting; still waiting… Normální během povolování RCM.
The agent restarted, so it has forgotten the operation. … Sekce znovu načte stav. Zkontrolujte, že RCM běží.
The agent on this server does not answer. Zkontrolujte, že běží služba agenta.
Another agent answers on the address of this server’s agent. Nothing was sent. agent_config_path označuje konfiguraci jiného agenta.

Režim goafts, režim RCM a režim agenta

Stránka pracuje s jedním ze tří klientů. Vezme první, který vyhovuje, v tomto pořadí:

  1. rcm_admin_url je nastaveno (ruční nastavení): režim RCM.
  2. Agent na tomto stroji (agent_config_path) má v agent_config.json položku cluster.source: rcm dává režim agenta, goafts dává režim goafts.
  3. Doručování konfigurace prostřednictvím goafts je nastaveno: režim goafts.
  4. agent_config_path je nastaveno: režim agenta.
Režim goafts Režim RCM Režim agenta
Kdy rcm_admin_url je prázdné (výchozí). rcm_admin_url je nastaveno. Viz pořadí výše.
Nastavení goafts_push_enabled=true, pět klíčů goafts_admin_* a users_mode=multiple. rcm_admin_url, rcm_admin_user a rcm_admin_password_file a rcm_admin_ca pro RCM, které používá TLS. Režim uživatelů single nebo multiple. Klíče goafts nejsou potřeba. Pouze agent_config_path. Žádné klíče rcm_admin_* ani goafts. Režim uživatelů single nebo multiple.
Kde konzole běží Kdekoli, odkud dosáhne na goafts. Na hostiteli RCM: konzole volá operátorský port RCM, obvykle https://127.0.0.1:7444. Na hostiteli RCM, vedle agenta, který spouští RCM. Agent předává každé volání trasám /v1/cluster/admin RCM na portu 7443 a přihlašuje se vlastním certifikátem.
Clustery Mnoho. Nejvýše jeden. Vytvořit funguje pouze tehdy, když RCM nemá žádný cluster. Jako v režimu RCM.

| Delete cluster | Smaže cluster, který nemá žádné členy. | Nezobrazuje se: RCM odmítne smazání, protože cluster existuje tak dlouho jako RCM. | Jako v režimu RCM. | | Agent suggestions | Servery, které tato konzole vidí. | Agentů, které se připojily k RCM. Odvolaní agenti se nenabízejí. | Jako v režimu RCM. |

Vše ostatní funguje ve všech režimech stejně: editor, Validate, Save s kontrolou revize, stav, žádosti o certifikáty, cluster CA, Re-key, Rotate CA a Retire.

V režimu RCM se konzole přihlašuje k RCM jako rcm_admin_user (HTTP Digest) a posílá login uživatele konzole s každou změnou. RCM vytvořené instalátorem obsluhuje svůj operátorský port přes TLS s certifikátem z vlastní CA clusteru. Nastavte rcm_admin_ca na tuto CA (certs/ca.crt ve složce RCM, například /opt/hqbirdrcm/certs/ca.crt), jinak se konzole nemůže připojit. Klíče rcm_admin_* jsou určeny pouze pro toto ruční nastavení.

V režimu agenta konzole nepotřebuje uživatele RCM, heslo ani CA. RCM zapisuje každou změnu do svého auditu jako agent:<agent id> (<console user>). Na hostiteli, kde agent neprovozuje RCM, stránka uvádí, který hostitel provozuje RCM jeho clusteru, a odkazuje na tuto konzoli RCM (https://<rcm host>:7444/). Když je agent starší než routy clusteru, stránka uvádí „Update fbagent". Když je RCM starší než jeho routy pro agenta, stránka uvádí „Update hqbirdrcm".

S users_mode=single stránka Servers zobrazuje tlačítko Clusters, když je nastaveno rcm_admin_url nebo agent_config_path. Jinak otevřete /clusters přímo.

Notifications

Tlačítko Notifications na stránce Servers otevírá stránku Notifications (/notifications). Zde nastavujete, kam agent na tomto stroji posílá své vlastní zprávy o problémech se serverem: Telegram, webhook (Slack, Teams, Discord, Mattermost, Rocket.Chat, ntfy nebo raw JSON) nebo e-mail. Práci dělá agent; stránka pouze čte a mění jeho nastavení prostřednictvím agentova Local API. Dokument fbagent NOTIFY.md popisuje stranu agenta: klíče a Local API.

Kdo smí stránku používat.

  • Každý přihlášený uživatel, který smí vidět server, může stránku číst.
  • Měnit cokoli může pouze administrátor. V režimu jednoho uživatele je to tento jeden uživatel. Jiný účet vidí řádek „This account cannot change notifications: changing notifications needs an administrator account" a žádná tlačítka.
  • Stránka funguje pouze pro agenta na tomto stroji (agent_config_path). Centrální konzole uvádí „There is no agent on this machine (agent_config_path), or this account may not see it. Notifications are set up on the server where the agent runs." a nenabízí nic k úpravám.
  • Agent, který neodpovídá, dává „Cannot ask the agent: …". Agent, který je příliš starý, uvádí „This agent is too old for notifications. Update the agent."
The Notifications page on a central console
The Notifications page on a central console

Obrázek je z centrální konzole, která nemá vlastního agenta. Zobrazuje pouze titulek, tlačítko Refresh, poznámku a řádek „There is no agent on this machine". Konzole s agentem na svém stroji zobrazuje celou stránku.

Co vidíte na konzoli s vlastním agentem

  1. Záhlaví s ← Servers a řádek drobečkové navigace Servers › Notifications.
  2. Titulek Notifications of the agent, tlačítko Refresh a poznámku: první zpráva přijde asi 20 minut poté, co problém začne.
  3. Název serveru tohoto agenta.
  4. Who sends: Mode, Sends now a Mode set at, seznam režimů s jedním řádkem každý a (pro administrátora) seznam režimů s Save mode.
  5. HQbird Telegram bot: upozornění prostřednictvím bota HQbird.
  6. Channels: tlačítko Add channel a tabulka kanálů.
  7. Delivery journal: posledních 50 doručení.

Když skončila zkušební verze nebo licence, červený řádek nad bloky uvádí: „The trial or license has ended. Notifications are switched off."

Who sends

Mode Who sends
Auto (default) Tento agent, když má povolený kanál. Jinak HQCenter.
This agent Pouze tento agent.
HQCenter Pouze HQCenter.
Both Tento agent a HQCenter.
Off Nikdo.

Sends now je výsledkem režimu: this agent, HQCenter nebo nobody. Například v režimu Auto bez povoleného kanálu uvádí HQCenter. V režimu HQCenter přicházejí upozornění ze sběrného centra a kanály této stránky se nepoužívají.

Chcete-li režim změnit: vyberte jej v seznamu a klikněte na Save mode. Stránka uvádí „Mode saved."

Add a Telegram channel with your own bot

Potřebujete telegramového bota a jeho token (od @BotFather) a chat, kde je bot členem.

  1. Klikněte na Add channel. Pod tabulkou se otevře formulář New channel.
  2. Zadejte Name: malá písmena, číslice, tečka, pomlčka nebo podtržítko. Název nelze později změnit.
  3. Zvolte Type: Telegram.
  4. Zadejte Bot token.
  5. Napište botovi libovolnou zprávu v chatu, který má dostávat upozornění.
  6. Klikněte na Find chat. Stránka se dotáže Telegramu na chaty, které botovi napsaly („Click a chat to use it:"). Klikněte na chat. Jeho ID se vloží do Chat ID. Pro téma skupiny zadejte také Thread ID (topic).
  7. Nastavte společná pole (viz níže), například Language.
  8. Klikněte na Save channel. Stránka uvádí „Channels saved."
  9. Klikněte na Send test na řádku kanálu. Stránka uvádí „Test message sent to …", nebo zobrazí chybu agenta.

Add a webhook or an e-mail channel

  • Webhook: Webhook URL, Format (raw, slack, mattermost, rocketchat, discord, teams nebo ntfy) a Auth header (Name: value), když jej příjemce potřebuje. Použijte formát programu, který zprávu dostává, například slack pro příchozí webhook Slacku.
  • E-mail (SMTP): Server address (host:port), User, Password, TLS (auto je implicitní TLS pro port 465, jinak STARTTLS), From a To (addresses separated by commas).

Poté klikněte na Save channel a Send test, jako u Telegramu.

Pole každého typu kanálu: Enabled, Minimum severity (info, warning, serious, critical), Message kinds (problems, resolved, silent server, reports, summaries, test; nic nezaškrtnuto znamená všechny druhy kromě test), Language, Short text, Quiet hours (22:00-07:00), Proxy URL a Max messages per hour.

Tajné údaje. Token, webhook URL, auth header a heslo nikdy nezobrazují svou uloženou hodnotu. Když je hodnota uložena, prázdné pole uvádí „stored; leave empty to keep". Novou hodnotu zadejte pouze pro její nahrazení.

Edit otevře formulář uloženého kanálu. Delete se nejprve zeptá „Delete channel …?". Cancel zavře formulář. Každé uložení odešle agentovi celý seznam kanálů.

Tabulka kanálů:

Column What it shows
Name, Type Název a typ kanálu.
On on nebo off.
Min. severity Nejnižší úroveň, kterou kanál odesílá.
Language Jazyk zpráv.
Pending Zprávy ve frontě kanálu.
Last success, Last error Čas posledního doručení a poslední chyba.

HQbird Telegram bot

S tímto blokem jdou upozornění do Telegramu z bota HQbird. Nepotřebujete vlastního bota. Upozornění procházejí přes server dodavatele HQbird a text zprávy prochází také přes tento server.

  1. Klikněte na Connect Telegram. Agent vytvoří jednorázový odkaz. Stránka zobrazí odkaz (otevře se na nové kartě) s Copy link, druhý odkaz pro přidání bota do skupiny a čas vypršení odkazu. Odkaz funguje jednou a platí 15 minut.
  2. Otevřete odkaz v Telegramu a stiskněte Start. Pokud je chat s botem již otevřený, Start nepředá kód: pošlete botovi zprávu /start <code>, kterou stránka zobrazuje pod odkazem. Má své vlastní tlačítko Copy.
  3. Zatímco je odkaz otevřený, stránka kontroluje každých 5 sekund. Když se chat objeví, stránka uvádí „Telegram is connected: …" a znovu načte blok a seznam kanálů. Při prvním propojení agent přidá kanál hqbird-bot.

Stránka přestane kontrolovat, když odkaz vyprší nebo když je karta prohlížeče skrytá. Poté klikněte znovu na Connect Telegram pro nový odkaz.

  • Tabulka připojených chatů zobrazuje Chat, Type (private, group, supergroup, channel) a Connected at. Disconnect se nejprve zeptá a poté chat odebere.
  • Blok také zobrazuje bota, zónu, „sent today N of M", stav licence, když licence není plně platná, a poslední chybu bota.
  • Když bot není dostupný (například žádná licence), blok zobrazuje důvod od agenta. Agent, který je příliš starý, uvádí „This agent version does not support the HQbird bot. Update the agent."

Odkaz používá aktuální jazyk stránky. Audit zaznamenává každé propojení a odpojení, bez odkazu a bez kódu.

Delivery journal

Posledních 50 doručení: Time, Channel, Result (sent, failed nebo expired) a Error. Chyba je text agenta nebo příjemce tak, jak je. Zkontrolujte pole, které chyba uvádí, a poté klikněte znovu na Send test.

Poznámka: první zpráva přijde asi 20 minut poté, co problém začne. Agent kontroluje stav serveru každých 10 minut a odešle zprávu poté, co druhá kontrola problém potvrdí. Agent nemůže hlásit, že jeho vlastní stroj je nedostupný.

Každá změna (režim, seznam kanálů, testovací zpráva) jde do auditu pouze s názvy a typy kanálů, nikdy s tokenem, URL nebo heslem.

Zprávy, které se mohou zobrazit

Message What it means
No channels yet. Klikněte na Add channel.
No chats found. Write a message to the bot and try again. Find chat nenašel žádný chat. Nejprve botovi napište.
Enter the bot token first. Find chat potřebuje token.
A channel with this name already exists. Zvolte jiný název.
Test to … failed: … Agent nemohl test doručit. Text uvádí důvod.
The agent cannot read its channel file: … Soubor notify_channels.json agenta je poškozený.
The link has expired. Click “Connect Telegram” to get a new one. 15 minut vypršelo.

Updates

Tlačítko Updates na stránce Servers otevírá stránku Updates (/updates). Zobrazuje, odkud agent na tomto stroji odebírá své verze a co mají a co se nabízí pro Firebird, HQ Monitor a fbmcp. Stránka je pro agenta, který není připojen k HQCenter: vzdálený agent odebírá své verze ze svého HQCenter.

Práva jsou stejná jako na stránce Notifications: každý uživatel, který smí vidět server, může stránku číst; pouze administrátor (nebo jediný uživatel v režimu jednoho uživatele) může změnit režim nebo použít balíček Firebird. Každá změna jde do auditu. Konzole bez agenta na tomto stroji uvádí „There is no agent on this machine (agent_config_path), or this account may not see it. A remote agent gets its releases from its HQCenter."

The Updates page
The Updates page

Obrázek je z centrální konzole, která nemá vlastního agenta. Zobrazuje pouze titulek, tlačítko Refresh a řádek „There is no agent on this machine". Konzole s agentem na svém stroji zobrazuje celou stránku.

Co vidíte na konzoli s vlastním agentem

  1. Záhlaví s ← Servers a řádek drobečkové navigace

Servery › Aktualizace. 2. Nadpis Aktualizace HQbird a tlačítko Obnovit. 3. Název serveru a údaje o jeho agentovi: Zdroj vydání (zóna aktualizací dodavatele, HQCenter nebo vypnuto), Zóna a Server aktualizací (včetně toho, jak je agent našel), Režim, Verze agenta, Poslední odpověď a Poslední selhání. 4. Co se aktualizuje samo: tři režimy, pouze pro zónu aktualizací dodavatele. 5. Firebird: Nainstalováno, Balíček, který čeká, Další okno aplikace, Proč čeká a Poslední aplikace. 6. HQ Monitor a fbmcp: tabulka se sloupci Produkt, Nainstalováno, Nabízeno, Poslední kontrola a Poznámka.

Co se aktualizuje samo:

Režim Co dělá
Agent Agent, HQ Monitor a fbmcp se aktualizují samy. Balíček Firebird se stáhne a čeká na vás.
All Firebird se také aktualizuje sám, ve svém okně aplikace (Firebird se restartuje).
Off Žádné kontroly aktualizací. Aktualizujte pomocí instalátoru.

Chcete-li to změnit: vyberte režim a klikněte na Uložit režim. Stránka oznámí „Režim uložen.“

Aplikace balíčku Firebird. Když balíček čeká, správce uvidí Aplikovat nyní. Aplikace zastaví Firebird, nainstaluje balíček a znovu spustí Firebird. Všechna připojení se uzavřou. Stránka se nejprve zeptá: „Aplikovat Firebird … na … nyní? Firebird se restartuje a všechna připojení se uzavřou.“ Poté oznámí „Agent zahájil aktualizaci. Firebird se restartuje; obnovte stránku za několik minut.“ Zvolte pro to klidnou dobu, nebo nechte režim All aplikovat balíček ve svém okně.

Zprávy, které se mohou zobrazit

Zpráva Co znamená
Tento agent je starší než zóny aktualizací: jeho aktualizace spravuje instalátor nebo jeho HQCenter. Aktualizujte agenta pomocí instalátoru.
Agent zatím nemá stav aktualizace Firebird. Agent zatím Firebird nezkontroloval.
žádný stav aktualizace na tomto agentovi Agent nemá o tomto produktu žádná data.
Nelze se dotázat agenta: … Agent neodpovídá. Zkontrolujte, že jeho služba běží.
Tento účet nemůže měnit aktualizace: … Váš účet není správce.

12. Instalace a nastavení pro správce

Instalace

  • Vedle agenta na Windows nebo Linuxu: použijte instalační skript. Viz LOCAL_INSTALL.md.
  • Za HTTPS s nginx: viz HTTPS_DEPLOYMENT.md.
  • Konzole nepotřebuje přístup k internetu. Své skripty, grafy a fonty poskytuje sama, takže funguje i v uzavřené síti.

Konfigurační soubor

Konzole čte jeden konfigurační soubor. Hledá ho v tomto pořadí a použije první nalezený soubor:

  1. Soubor uvedený v proměnné prostředí FBMONITOR_CONFIG_PATH. Když je tato proměnná nastavena, konzole nikde jinde nehledá.
  2. fbmonitor.properties, poté config.properties, ve složce programového souboru.
  3. fbmonitor.properties, poté config.properties, v pracovní složce.

Soubor config.example.properties uvádí každý klíč s komentářem. Řádky začínající znakem # jsou komentáře. Většina klíčů má také proměnnou prostředí FBMONITOR_<KEY>, například FBMONITOR_PORT. Proměnná má přednost před souborem. users_mode a draft_keep_days proměnnou nemají. Relativní cesta v klíči souboru (například audit_file nebo rcm_admin_password_file) se bere ze složky konfiguračního souboru.

Nejdůležitější klíče:

Klíč Výchozí Co nastavuje
data_path žádný Složka s daty agentů. Povinné.
port 8080 HTTP port.
data_timezone žádný Časové pásmo datových souborů, když ho agent nehlásí.
users_mode single single nebo multiple.
initial_admin_password_file žádný Kam se uloží heslo prvního správce, když režim multiple vytvoří users.enc. Bez něj se heslo jednou vypíše do logu.
access_properties_path žádný Cesta k access.properties pro režim single. Použije se, když agent_config.json agenta neobsahuje přihlášení.
agent_config_path žádný Živý agent_config.json místního agenta. Zapíná lokální režim a obsahuje přihlášení pro režim single (fbagent 2.80.0 nebo novější). Také poskytuje sekci Cluster na tomto serveru a stránku Clustery prostřednictvím agenta.
bind_address, behind_proxy všechna rozhraní, false Použijte 127.0.0.1 a true, když je před konzolí nginx.
require_https_for_secrets false false: heslo Firebirdu můžete zadat v editoru konfigurace přes prosté HTTP a zobrazí se varování, že připojení není šifrované. true: pole hesla zůstane jen pro čtení, dokud požadavek nepřijde přes HTTPS.
goafts_push_enabled, goafts_admin_* false, žádný Doručování konfigurace vzdáleným agentům. Pět klíčů goafts_admin_* je URL, klientský certifikát, jeho klíč, CA a soubor s tokenem.
goafts_server_list true Když je nastaveno pět klíčů goafts_admin_*, stránka Servery bere své řádky ze seznamu serverů goafts a nečte každou složku serveru. Složky čte, když seznam není použitelný. false: vždy číst složky.
config_drift_minutes 10 Po kolika minutách bez odpovědi agenta se stav doručení zobrazí jako DRIFT (viz Stav doručení). 0 nebo nesprávná hodnota znamená 10.
draft_keep_days 30 Kolik dní konzole uchovává staré koncepty konfigurace agenta (aplikované nebo zastaralé). 0 uchovává všechny.
rcm_admin_url, rcm_admin_user, rcm_admin_password_file, rcm_admin_ca žádný Ruční nastavení stránky Clustery přes admin API RCM, bez goafts (viz režim goafts, režim RCM a režim agenta). Vedle agenta, který spouští RCM, nejsou potřeba: stránka funguje prostřednictvím agenta. rcm_admin_ca je soubor CA, proti kterému se ověřuje certifikát RCM; prázdná hodnota znamená systémové úložiště.
chatwoot_enabled, chatwoot_*, support_email false Chat podpory na obrazovce serveru: bublina v pravém dolním rohu, která otevře okno chatu.
audit_file hqmonitor_audit.log vedle konfiguračního souboru Auditní log.

Klíč refresh_interval_sec se již nepoužívá. Konzole ho ignoruje a zapíše varování do svého logu.

Po změně souboru konzoli restartujte. Restart odhlásí všechny uživatele.

Některé soubory se čtou znovu při každém použití, takže změna nevyžaduje restart:

  • goafts_admin_token_file: čte se při každém volání goafts. Token můžete obměnit za běhu konzole.
  • rcm_admin_password_file: čte se při každém požadavku stránky Clustery. Zalomení řádku na konci se ignoruje.
  • users.enc v režimu multiple: čte se při každém požadavku.

Konzole uchovává přihlášení v cookie fbmonitor_auth_<port>, například fbmonitor_auth_8080. Název pochází z klíče port. Prohlížeč uchovává cookies podle hostitele, nikoli podle portu, takže port v názvu umožňuje dvěma konzolím na jednom hostiteli uchovávat oddělená přihlášení.

  • Přihlášení trvá 7 dní.
  • Konzole vytváří při každém startu nový podpisový klíč. Restart odhlásí všechny uživatele.
  • V režimu multiple nové heslo účtu odhlásí tento účet ve všech prohlížečích.

Datová složka

Konzole čte složku v data_path. Pro každý server existuje jedna složka, pojmenovaná podle agenta. Uvnitř:

Složka Použití
server_level/cpuram Grafy CPU, zátěže a paměti
server_level/GetActiveDatabases Připojení a databáze
server_level/diskspace, firebird_files Místo na disku a dočasné soubory
server_level/diskio Latence a propustnost disku (úloha agenta collect_disk_io)
server_level/log_files Stránka Logy
server_level/statuses, aireport Sloupec stavu a zpráva o stavu
server_level/perfreport Perf Report a karta Dotazy
server_level/tracesummary, traceperminute, lwmmon Nejpoužívanější dotazy, stránka Chyby, tabulky připojení
server_level/conflict_reports, conf_changes Stránky Konflikty a Konfigurace
server_level/agent_config Editor konfigurace ve vzdáleném režimu
<database>/DatabaseMetrics Grafy databáze
<database>/AdvancedDbStats, ClientVersions Stránky Metriky a Verze klientů
<database>/*_gstat_full.log Stránka Statistiky

13. Řešení potíží

Nemohu se přihlásit. Zkontrolujte zprávu na přihlašovací stránce. Pokud uvádí access.properties nebo users.enc, musí správce opravit nastavení konzole. V režimu single s fbagent 2.80.0 nebo novějším může správce nastavit nové heslo na hostiteli agenta pomocí fbagent --reset-hqmonitor-password. Všechny otevřené relace tím skončí.

Byl jsem odhlášen. Konzole byla restartována nebo správce vašemu účtu přidělil nové heslo. Přihlaste se znovu.

Server není v seznamu. V režimu multiple požádejte správce, aby vám server přiřadil. Pokud jste správce, zkontrolujte, že agent zapisuje data do data_path.

Grafy jsou prázdné. Zvolte jiné datum pomocí Zvolit datum. Lze vybrat pouze dny s daty. Pokud nelze vybrat žádný den, agent ještě neodeslal data.

Data jsou stará. Stiskněte F5. Stránky se neobnovují samy. Pokud čas pod stavem na stránce Servery zůstává starý, zkontrolujte agenta na tomto serveru.

Časy vypadají špatně. Konzole zobrazuje časové pásmo serveru. Zkontrolujte odznak pásma poblíž ovládacích prvků času.

Odkazy Úlohy a Zálohy chybí. Agent ještě neodeslal svou konfiguraci. Starší agenti ji neodesílají.

Stránka Zálohy je prázdná. Agent ještě nezaznamenal žádnou zálohu. Inventář se plní, jak zálohy běží, a plně při další kontrole stavu záloh (každé 2 hodiny).

Karta Dotazy chybí ve zprávě o statistikách. Žádný použitelný výkonnostní report nekončí do 23 hodin od snímku. Zkontrolujte Perf Report pro daný den.

Úloha zobrazuje „gates differ“. Příznak sekce a úloha plánovače úlohy se neshodují, takže úloha neběží. Přečtěte důvod pod slovem stavu. Uvádí přepínač, který je vypnutý, například „section off“ nebo „tick off“. Nebo použijte opravu na kartě Problémy.

Uložit a odeslat agentovi chybí. Doručování je na této konzoli vypnuto nebo váš účet nemá Smí odesílat konfiguraci agentům.

Spustit nyní je zašedlé. Namiřte na tlačítko. Popisek uvádí důvod: vašemu účtu chybí Smí spouštět úlohy na agentech, nastavení doručování je neúplné, agent má vzdálené příkazy vypnuté nebo je agent starší než 2.61.0.

Stav zobrazuje DRIFT. Agent neodpověděl 10 minut nebo déle poté, co byla změna odeslána (čas nastavuje klíč config_drift_minutes). Zkontrolujte, že agent běží a může dosáhnout na goafts.

Stránka Clustery zobrazuje „clusters are edited through RCM’s admin API, which this console is not set up for: …“. rcm_admin_url je nastaven, ale chybí jiné nastavení RCM. Konec zprávy ho uvádí:

  • „rcm_admin_user is not set“: přidejte rcm_admin_user a restartujte konzoli.
  • „rcm_admin_password_file is not set“: přidejte klíč a restartujte konzoli.
  • „rcm_admin_password_file cannot be read: …“ nebo „rcm_admin_password_file … holds no password“: opravte soubor. Konzole ho čte při každém požadavku, takže restart není potřeba.
  • „rcm_admin_ca cannot be read: …“: opravte cestu v rcm_admin_ca a restartujte konzoli.

Stránka Clustery zobrazuje „clusters are edited through goafts’ admin API, which this console is not set up for: …“. rcm_admin_url je prázdné, takže stránka používá goafts a doručování konfigurace není nastaveno. Konec zprávy uvádí chybějící nastavení, například „goafts_push_enabled is false, …“ nebo „users_mode is not multiple, …“. Nastavte doručování. Na hostiteli RCM bez goafts nastavte agent_config_path: stránka pak funguje prostřednictvím agenta, který spouští RCM. Klíče rcm_admin_* jsou pro ruční nastavení (viz režim goafts, režim RCM a režim agenta).

Stránka Clustery uvádí „The agent on this server is too old for this page. Update fbagent.“

Agent na tomto serveru nemá clusterové trasy (/v1/cluster/admin). Aktualizujte fbagent.

Stránka Clusters zobrazuje „The RCM on this server is too old for this page. Update hqbirdrcm.“ Agent požadavek předal, ale RCM tohoto hostitele nemá pro svého agenta administrátorské trasy (port 7443). Aktualizujte hqbirdrcm.

Stránka License zobrazuje u serveru NO DATA. Agent tohoto serveru je starší než podpora licencí, nebo ještě nezapsal svou první zprávu. Aktualizujte agenta nebo počkejte.