HW SOLUTIONHARDWARE. ŘÍZENÍ. SOUVISLOSTI.
Úvod/Freeware/SNMPv3 Tool
HW / DOKUMENTACE SNMPv3 Tool

Formát CSV.

Sloupce, kódování a příklady seznamu OID pro přesné čtení hodnot i celých podstromů.

Zpět na aplikaci

Od verze 1.2.0 lze nahrát jeden CSV soubor s přesnými OID hodnot nebo s kořeny celých podstromů. MIB je volitelná; pokud ji nahrajete, doplní typy, enumerace, jednotky a DESCRIPTION. CSV poskytuje seznam požadovaných dotazů a vlastní názvy a popisy.

Použití

  1. Zvolte Načíst OID z CSV… a vyberte soubor. Import ověří celý obsah; při chybě ukáže řádek a zachová dosavadní seznam i výsledky.
  2. Na kartě OID z CSV uvidíte načtené položky a jejich režimy. Automaticky se zapne Číst celý CSV seznam; pole Kořenový OID je v tomto režimu vypnuté.
  3. Vyplňte připojení a přihlášení SNMPv3 a stiskněte Vyčíst CSV seznam. Režim každého řádku určuje, zda se přečte přesná hodnota nebo celý podstrom. Výběr GETBULK / GETNEXT se používá u podstromů.
  4. Kliknutím na položku zobrazte hodnotu a popis. Pod kořenem WALK jsou dostupné vyčtené instance. V detailu jsou údaje z CSV označené samostatně vedle skutečných metadat MIB.

Kliknutí na objekt ve stromu MIB během klidového stavu přepne čtení zpět na vybranou větev. Celý CSV seznam znovu zapnete zaškrtávacím políčkem nebo výběrem položky CSV. Ověřit spojení v režimu CSV otestuje první cíl; celý seznam vyčte hlavní tlačítko. Nápověda → Odebrat CSV seznam odstraní seznam a dosavadní výsledky, MIB zůstane načtená.

Šablonu uložíte přímo z aplikace přes Nápověda → Uložit ukázkové CSV…. Dodané soubory:

  • OID-BLOCK.csv — obecný seznam standardních OID.
  • HW-DEMO-OIDS.csv — seznam pro místní testovací agent; k jinému zařízení se tyto ukázkové OID nevztahují.

Sloupce

První neprázdný řádek je hlavička. Pořadí sloupců je libovolné; názvy nerozlišují velká a malá písmena. Sloupce lze vynechat kromě oid.

Sloupec Povinný Význam
oid ano Číselný OID, například 1.3.6.1.2.1.1.5.0. Počáteční tečka je povolena; symbolické názvy se nepřijímají.
mode ne get (výchozí při vynechání nebo prázdné buňce) čte přesně daný OID. walk přečte podstrom pod tímto OID. Přijímá se také hlavička režim nebo rezim.
name ne Vlastní název, nejvýše 200 znaků. Přijímá se také název nebo nazev. Ve výsledku má přednost rozpoznaný symbol z MIB; vlastní název je vždy dostupný v seznamu a detailu CSV.
description ne Vlastní popis, nejvýše 4000 znaků. Přijímá se také popis. Doplňuje DESCRIPTION MIB a nezaměňuje se s ním.

Příklad se středníky:

oid;mode;name;description
1.3.6.1.2.1.1.1.0;get;Popis zařízení;Přesná instance sysDescr.0
1.3.6.1.2.1.1.5.0;get;Název zařízení;Přesná instance sysName.0
1.3.6.1.2.1.2.2;walk;Síťová rozhraní;Celý podstrom ifTable

Nejmenší použitelný soubor má pouze jeden sloupec a všechny řádky přečte přes GET:

oid
1.3.6.1.2.1.1.1.0
1.3.6.1.2.1.1.5.0

Pro skalár v režimu GET uveďte jeho instanci, obvykle včetně koncové .0. U sloupce tabulky je třeba úplný index instance. Pro načtení všech řádků sloupce nebo tabulky použijte jeho kořen a walk. Při importu se chybějící index automaticky nedoplňuje.

Zápis a omezení

  • Oddělovač může být středník, čárka nebo tabulátor; rozpozná se podle hlavičky. V celém souboru používejte stejný oddělovač a stejný počet buněk jako v hlavičce.
  • Kódování je UTF-8 s BOM nebo bez BOM, případně Windows-1250. Při přípravě souboru doporučujeme UTF-8. UTF-16 je třeba před importem převést.
  • Text s oddělovačem nebo novým řádkem uzavřete do dvojitých uvozovek. Uvozovku uvnitř textu zapište dvojmo, například "Popis; s ""uvozovkami""".
  • Prázdné řádky se přeskakují; mezery na okrajích buněk se odstraní. Každý další neprázdný řádek musí mít platný OID. Komentářové řádky ani neznámé sloupce formát neobsahuje.
  • OID musí být jedinečné i po odstranění úvodní tečky a normalizaci číslic. Každý sloupec smí být v hlavičce pouze jednou, včetně jeho českých aliasů.
  • Limit je 1000 OID a 2 MB na soubor. OID má nejvýše 128 částí, každou v rozsahu 0 až 4294967295; kontroluje se také platný začátek OID.
  • Přihlašovací údaje vyplňte v aplikaci. Profil připojení neukládá CSV seznam; při novém spuštění CSV znovu načtěte.

Výsledek čtení seznamu

Cíle se čtou v pořadí CSV v jedné SNMPv3 relaci. Časový limit a limit hodnot jsou společné pro celý seznam. Pokud se podstromy překrývají, každý výsledný OID se zobrazí pouze jednou. Zrušení, chyba nebo vyčerpaný limit ponechají dosavadní hodnoty a označí výsledek jako částečný; zpráva uvede počet dokončených cílů.

GET bez vrácené instance nebo prázdný WALK se mohou dokončit bez hodnot. Položky jsou dostupné na kartě Bez instance s označením CSV. Pokrytí MIB se počítá pouze pro skutečné čitelné definice v požadovaných cílech. CSV cíl a definice MIB se proto mohou objevit jako dva samostatné záznamy bez hodnot.

JSON export uchovává read_scope: "csv_list", celý seznam targets s režimy, názvy, popisy a stavem dokončení, completed_targets a targets_without_values. Původní root_oid u seznamu obsahuje první cíl; úplný rozsah určují položky targets. CSV export obsahuje hodnoty i CSV cíle bez výsledků a označení úplného nebo částečného čtení.