Juniper NETWORKS Broadband Edge Event Collection a vizualizace

O této příručce
Použijte tuto příručku k instalaci Broadband Edge Event Collection and Visualization.

Broadband Edge Event Collection a instalace vizualizace

• Nainstalujte kolekci a vizualizaci událostí Broadband Edge | 2
• Jak používat příkazy nástroje Broadband Edge Event Collection a vizualizace | 11

Nainstalujte kolekci a vizualizaci událostí Broadband Edge

SHRNUTÍ
Tato část popisuje instalační postupy a systémové požadavky pro Broadband Edge Event Collection a vizualizaci.

Broadband Edge (BBE) Event Collection and Visualization je aplikace pro shromažďování událostí, která má fungovat s cloudovými aplikacemi Juniper BBE, jako je Juniper BNG CUPS Controller a Address Pool Manager (APM). BBE Event Collection and Visualization shromažďuje události syslog a zaznamenává je do databáze časových řad. Můžeš view zaznamenané události prostřednictvím BBE Event Collection and Visualization Dashboard. BBE Event Collection and Visualization Dashboard je vizualizační nástroj založený na GUI, který vám to umožňuje view zaznamenávané události podle definovaného filtru, který může být v určitém časovém rozmezí. Dashboard také poskytuje výkonné vyhledávací a vizualizační nástroje, jejichž prostřednictvím můžete korelovat zaznamenané události z více zdrojů (např.ample, z APM nebo clusteru Kubernetes).

Než začnete

Než začnete instalovat a spouštět BBE Event Collection and Visualization, ujistěte se, že máte následující:

• Uživatelský účet juniper.net s oprávněním ke stažení softwarového balíčku BBE Event Collection and Visualization.
• Hostitel Linuxu (jump host) se systémem Ubuntu 22.04 LTS (nebo novějším je vyžadován) pro spuštění instalace do auta.
• Hostitel skoku musí mít následující:
• Jádra CPU – 2
• RAM - 8 GB
• Místo na disku – 128 GB volného místa na disku
• Nainstalované virtuální prostředí Python 3
• Přihlášení uživatele s přístupem ke clusteru Kubernetes
• Externí přístup k Docker Hub (docker.io) pro stahování obrázků kontejnerů s otevřeným zdrojovým kódem potřebných pro nasazení BBE Event Collection and Visualization.
• Cluster musí mít alespoň tři pracovní uzly (buď virtuální nebo fyzické počítače). Uzel je systém Linux se systémem Ubuntu 22.04 LTS (nebo novějším), který má adresu pro správu a název domény. Uzly musí splňovat následující systémové požadavky:
• CPU jádra — 8 (preferováno hyperthreading)
• RAM - 64 GB
• Místo na disku – 512 GB volného místa na disku v kořenovém oddílu

Nainstalujte kolekci a vizualizaci událostí Broadband Edge
SHRNUTÍ

• Tento postup použijte k instalaci BBE Event Collection and Visualization.
• Než začnete, potvrďte, že jste splnili požadavky na instalaci BBE Event Collection and Visualization.

POZNÁMKA: Pokyny k instalaci zařízení BBE Cloudsetup a vytvoření clusteru Kubernetes najdete v instalační příručce BBE Cloudsetup. Pokud během každého nastavení použijete možnost bbecloudsetup [–bbecloudsetup], všechna výchozí nastavení se shodují s BBE Cloudsetup. Pokud s nastavením nepoužíváte možnost bbecloudsetup, musíte mít při spuštění instalace BBE Event Collection and Visualization následující informace:

• Umístění registru Kubernetes
• Název registru
• Port registru

Nainstalujte aplikaci BBE Event Collection and Visualization

1. Stáhněte si softwarový balík BBE Event Collection and Visualization ze stránky pro stažení softwaru Juniper Networks a uložte jej do hostitele skoku.
   BBE Event Collection and Visualization je k dispozici jako komprimovaný tarball image (.tgz). The filenázev obsahuje jako součást názvu číslo vydání. Číslo vydání má formát:
   . .
   • major je hlavní číslo vydání produktu.
   • minor je vedlejší číslo vydání produktu.
   • údržba je číslo revize.
2. Rozbalte soubor BBE Event Collection and Visualization tarball (.tgz) file na hostiteli skoku zadáním:
   POZNÁMKA: Kolekce a vizualizace událostí BBE files jsou rozbaleny do adresáře bbe-ecav.
3. Po rozbalení tarballu spusťte zaváděcí skript.
4. K propojení s clusterem použijte příkaz sudo -E ecav link –context context-name –version ecav-version. Příkaz link přidruží načtený softwarový balík BBE Event Collection and Visualization ke clusteru v rámci přípravy na nastavení.
   • kontext-název – kontextový název Kubernetes (název clusteru).
   • av-version – verze softwaru BBE Event Collection and Visualization.
5. Pokud používáte zabezpečený registr (napřample, cluster vytvořený BBE Cloudsetup), ověřte registr vydáním přihlašovacího jména dockeru jako systémový uživatel (informace o systému a uživateli poskytnuté v konfiguraci clusteru BBE Cloudsetup file) na přenosovou adresu registru clusteru (FQDN zadaný jako systémová adresa v konfiguraci clusteru BBE Cloudsetup file).
6. Spusťte instalační program a nakonfigurujte instalaci. Pokud jste ke konstrukci clusteru použili BBE Cloudsetup, můžete do příkazu setup přidat volbu –bbecloudsetup, abyste přijali výchozí hodnoty pro registr, službu ukládání protokolů a počet replikací OpenSearchDB. Během nastavení budete muset zadat následující informace:
   • A URL pro přístup k řídicímu panelu BBE Event Collection a Visualization. Zadejte název DNS pro systémovou adresu používanou BBE Cloudsetup.
   • Administrativní heslo (musí mít minimálně osm znaků a musí obsahovat alespoň jedno velké písmeno, jedno malé písmeno, jedno číslo a jeden speciální znak).
   • kontext-název – kontextový název Kubernetes (název clusteru).
   • bbecloudsetup – používá výchozí hodnoty použité při vytváření clusteru Kubernetes BBE Cloudsetup.
     Příkaz setup shromažďuje informace o prostředí klastru, jako je; umístění registru kontejnerů, vstup URL, počet replikací OpenSearch a tak dále.
7. Ověřte verzi instalace BBE Event Collection and Visualization – kontextový-název kontextu – detail.

• kontext-název – kontextový název Kubernetes (název clusteru).

Spusťte shromažďování a vizualizaci událostí Broadband Edge

SHRNUTÍ
Tento postup použijte ke spuštění BBE Event Collection and Visualization.

Zadejte rollout a spusťte instalaci BBE Event Collection and Visualization. Nástroj BBE Event Collection and Visualization vám umožňuje zavést různé verze softwaru pro všechny mikroslužby, které jsou součástí BBE Event Collection and Visualization. Musíte použít příkaz rollout se sudo jako root. Příkaz rollout také ověří, zda jsou přítomny všechny hodnoty potřebné pro nová vydání, a načte obrazy kontejneru nových verzí do registru. Použijte sudo -E can rollout –context contextName [–version software-release ] ke spuštění služeb BBE Event Collection a Visualization. Napřampten:

• kontext-název – kontext Kubernetes (název clusteru).
• Zadejte každý stav – detail – kontextový název, abyste ověřili, že jsou služby BBE Event Collection a Visualization v provozu. Napřampten:

• kontext-název – kontext Kubernetes (název clusteru).

POZNÁMKA: Shromážděte protokoly pro servis a kontaktujte středisko technické pomoci Juniper Networks (JTAC), pokud nastane některá z následujících situací:

• Služba není spuštěna.
• Doba provozu služby ve srovnání s jinými službami naznačuje, že byla restartována.

Použití Broadband Edge Event Collection and Visualization Dashboard
K vyhledávání protokolů nebo generování sestav můžete použít panel BBE Event Collection and Visualization. Zprávy jsou užitečné pro generování zpráv o problémech a obecné ladění.
Podrobné informace o nástroji Broadband Edge Event Collection a Visualization Dashboard najdete v dokumentaci OpenSearch, https://opensearch.org/docs/2.9/dashboards/quickstart/.

Vytvořte indexový vzor k zobrazení

Chcete-li začít s řídicím panelem BBE Event Collection and Visualization, musíte nejprve vytvořit vzor indexu, který má řídicí panel zobrazovat.
Chcete-li vytvořit vzor indexu, proveďte následující:

1. Přihlaste se do URL pro přístup k řídicímu panelu BBE Event Collection and Visualization, který jste nastavili během procesu instalace BBE Event Collection and Visualization. Pro přihlášení použijte administrátorské uživatelské jméno a heslo, které jste zadali během BBE Event Collection a nastavení vizualizace.
2. Vytvořte vzor indexu, který má řídicí panel zobrazovat.

POZNÁMKA: Doporučujeme nejprve nainstalovat a zavést aplikaci BBE, aby se vzor indexu shodoval s událostmi. Vzor indexu můžete vytvořit pouze v případě, že existuje alespoň jeden odpovídající index.

• Po přihlášení se zobrazí stránka Začít přidáním dat. Na stránce Začít přidáním dat vyberte možnost Prozkoumat sám.
• Na stránce Vyberte svého tenanta vyberte přepínač Soukromé a klikněte na Potvrdit. Zobrazí se řídicí panel BBE Event Collection and Visualization.
• Z rozbalovací nabídky (tři 3 vodorovné čáry v levé horní části okna řídicího panelu) vyberte Správa > Správa řídicího panelu. Zobrazí se stránka Správa řídicího panelu.
• Na stránce Správa řídicího panelu vyberte Indexové vzory. Zobrazí se stránka Vzory indexu.
• Na stránce Vzory rejstříku klikněte na tlačítko Vytvořit vzor rejstříku umístěné na pravé straně stránky.
• V kroku 1: Definování stránky vzoru indexu zadejte řetězec logstash-bbe-ecav* do pole Název vzoru indexu a klikněte na tlačítko Další krok.

POZNÁMKA: Zástupný znak hvězdička (*) umožňuje porovnat více dní vzorců indexu.

• Na stránce Krok 2: Konfigurace nastavení vyberte @timestamp v rozevíracím seznamu Časové pole a klepněte na tlačítko Vytvořit vzor indexu.
• Pomocí rozbalovací nabídky přejděte zpět na stránku Objevit. Zobrazí se všechny vygenerované protokoly pro vaše aplikace BBE.

POZNÁMKA: Vzor indexu můžete vytvořit pouze v případě, že existuje alespoň jeden odpovídající index.

Jak změnit časový rozsah

Můžete změnit časový rozsah informací, které chcete zobrazit na stránce Objevit. Na stránce Objevit se zobrazují informace protokolu.

Chcete-li změnit časový rozsah zobrazených informací o události:

1. Na řídicím panelu BBE Event Collection and Visualization klikněte na Discover, zobrazí se stránka Discover.
2. Na stránce Objevit klikněte na ikonu kalendáře v pravé horní části stránky. Zobrazí se pole pro výběr časového rozsahu.
3. V poli pro výběr časového období vyberte časové období, pro které chcete zobrazit informace, a klikněte na Použít. Informace pro vybrané časové období se zobrazí na stránce Objevit.

Jak přizpůsobit výstup událostí
Informace, které chcete zobrazit na stránce Objevit, si můžete přizpůsobit. Na stránce Objevit se zobrazují informace protokolu. Chcete-li přizpůsobit výstup události:

1. Na řídicím panelu BBE Event Collection and Visualization klikněte na Discover a zobrazí se stránka Discover.
2. Na levé straně stránky Objevit jsou všechna dostupná pole uvedena v poli Dostupná pole.
3. Chcete-li zobrazit informace na stránce Objevit, klikněte na ikonu plus vedle pole, které chcete přidat.

Pole se přidá na stránku Objevit spolu s odpovídajícími informacemi pro pole.

POZNÁMKA: Doporučujeme, abyste začali přidáním následujících polí:

• Čas
• hostitel. název hostitele
•  proces. název
• zpráva

Jak vytvořit zprávu

Můžete uložit a poté stáhnout informace, které se objeví na stránce Objevit. Na stránce Objevit se zobrazují informace protokolu.
Chcete-li vytvořit přehled:

1. Na řídicím panelu BBE Event Collection and Visualization klikněte na Discover a zobrazí se stránka Discover.
2. Na stránce Objevit klikněte v horní nabídce na Uložit. Zobrazí se dialogové okno Uložit hledání.
3. Do pole Název zadejte název uloženého vyhledávání a klikněte na Uložit. Název uloženého vyhledávání se zobrazí na stránce Objevit (vlevo nahoře).
4. Po uložení vyhledávání klikněte v horním menu na Hlášení. Zobrazí se dialogové okno Generovat a stáhnout.
5. Vyberte Generovat CSV. Přehled se stáhne jako CSV file.

Jak na to Hledat Events Using DQL Search
V řídicím panelu BBE Event Collection and Visualization můžete k vyhledávání událostí použít Dashboard Query Language (DQL). Můžete použít zástupné znaky a vytvořit filtry pro vyhledávání informací o konkrétních událostech.
Podrobné informace o používání DQL naleznete v dokumentaci OpenSearch, https://opensearch.org/docs/2.9/dashboards/discover/dql/.

Chcete-li vyhledat informace o události pomocí vyhledávání DQL:

1. Na řídicím panelu BBE Event Collection and Visualization klikněte na Discover, zobrazí se stránka Discover.
2. Na stránce Objevit zadejte informace, které hledáte, do pole Vyhledávání DQL (umístěného v levé horní části stránky). Ujistěte se, že je pro vyhledávací pole vybráno DQL.
3. V případě potřeby můžete také vytvořit filtry, které použijete při hledání informací, které hledáte. Vyberte Přidat filtr. Zobrazí se dialogové okno Upravit filtr.
4. Pomocí dialogového okna Upravit filtr přizpůsobte svůj filtr a klikněte na Uložit. Stránka Discover zobrazuje vaše informace podle vyhledávání DQL.

Jak používat příkazy nástroje Broadband Edge Event Collection a vizualizace

SHRNUTÍ
Po instalaci Broadband Edge Event Collection and Visualization můžete provádět četné administrativní funkce.

Přístup ke shromažďování událostí širokopásmového připojení a příkazům vizualizačního nástroje

Ke správě aplikace a přístupu k rozhraní příkazového řádku, které používáte pro konfiguraci operací, můžete použít skript nástroje Broadband Edge Event Collection and Visualization (ecav). Broadband Edge Event
Instalace kolekce a vizualizace umístí skript nástroje do /usr/local/bin.
Skript obslužného programu ecav provádí úkoly, které potřebujete ke správě shromažďování a vizualizace událostí Broadband Edge, ale maskuje složitost příkazu kubectl. Toto maskování příkazů kubectl zjednodušuje vaše administrativní povinnosti.
Skript nástroje ecav používá příkazy nástroje Kubernetes kubectl k následujícímu:

• Vytvářejte a mažte objekty.
• Poskytněte přístup k protokolu.
• Provádějte interaktivní sezení s kontejnery pod.
• Zobrazte stav objektů Kolekce událostí na okraji širokopásmového připojení a Vizualizace.

Tabulka 1 na stránce 12 uvádí příkazy, které můžete vyvolat pomocí skriptu nástroje ecav, a popisuje
akci, kterou každý příkaz spouští.
Tabulka 1: Příkazy skriptu širokopásmového shromažďování událostí okraje a nástroje vizualizace

Název příkazu	Akce
ecav clean [–uvolnění číslo vydání][–docker] [–dry-run][–uninstall]	Odebere nepoužívané verze softwaru a můžete jej použít k odinstalaci aplikace. Tento příkaz nabízí následující možnosti: • uvolnit číslo—Čísla vydání, která chcete vyčistit (odstranit). Výchozí nastavení je odstranit nepoužívaná vydání. Zadejte požadovaná čísla vydání.   • docker – Vyčistí místní mezipaměť dockeru.   • dry-run – uvádí seznamy nebo kontejnery, které budou příkazem odstraněny.   • uninstall – Odinstaluje všechna vydání softwaru a odebere BBE Edge Event Collection a Visualization ze systému.
sudo -E může cluster- rename –context kontextové jméno -nové jméno nové jméno	Přejmenuje cluster, ke kterému je připojena shromažďování a vizualizace událostí Broadband Edge. Přejmenování clusteru nemá vliv na službu Broadband Edge Event Collection and Visualization. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnosti:   • kontext kontextové jméno—Starý název clusteru Kubernetes k přejmenování. Zadejte název clusteru.   • nové jméno nové jméno—Nový název clusteru Kubernetes. Zadejte nový název.
av ip – kontext kontextové jméno [-o| — výstupní json] [–detail]	Zobrazuje IP adresy každé služby s externí IP adresou. Tento příkaz nabízí následující možnosti: • kontext kontextové jméno– Název clusteru Kubernetes. Zadejte název clusteru.   • Output JSON – Umožňuje požádat o výstup ve formátu JSON.   • detail – Zobrazuje podrobné informace o IP.

Název příkazu	Akce
sudo -E can link — verze vydání softwaru -kontext kontextové jméno	Propojí cluster s konkrétní verzí softwaru. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnosti:   • verze vydání softwaru—Uveďte verzi softwaru, kterou chcete propojit s úložištěm specifickým pro klastr.   • kontext kontextové jméno– Název clusteru Kubernetes, který se má propojit s vydáním softwaru. Zadejte název clusteru.
sudo -E can rollout — kontext kontextové jméno — verze vydání softwaru]	Upgradujte službu Broadband Edge Event Collection a vizualizace. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnosti:   • kontext kontextové jméno– Název clusteru Kubernetes, na kterém se má zavést nová verze softwaru. Zadejte název clusteru.   • verze vydání softwaru—Vydání softwaru, které bude spuštěno. Zadejte číslo verze softwaru.
sudo -E can setup — kontext kontextové jméno [– výchozí] [–aktualizace]	Nastaví aplikaci Broadband Edge Event Collection and Visualization jako součást procesu instalace. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnosti:   • kontext kontextové jméno– Název clusteru Kubernetes, na kterém se má spustit spuštění. Zadejte název clusteru.   • default – Nastavení používá výchozí hodnoty, které byly zadány při vytváření clusteru BBE Cloudsetup.   • update – Budete dotázáni pouze na chybějící hodnoty během nastavení.

Název příkazu	Akce
sudo -E může začít — kontext kontextové jméno	Spustí specifickou službu Broadband Edge Event Collection and Visualization. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnost:   • kontext kontextové jméno— Název clusteru Kubernetes, na kterém se spustí shromažďování a vizualizace událostí Broadband Edge. Zadejte název clusteru.
stav ecav – kontext kontextové jméno [-o|–výstup json]	Zobrazuje aktuální stav služeb Broadband Edge Event Collection a Visualization. Tento příkaz nabízí následující možnosti:   • kontext kontextový název– Název clusteru Kubernetes. Zadejte název clusteru.   • output (výstup) – umožňuje požádat o výstup ve formátu JSON.
sudo -E může zastavit — kontext kontextové jméno -Nyní	Zastavte všechny služby shromažďování a vizualizace událostí Broadband Edge. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnost:   • kontext kontextové jméno—Název clusteru Kubernetes, na kterém se má zastavit shromažďování a vizualizace událostí Broadband Edge. Zadejte název clusteru.   • now – Pokud tento volitelný příkaz nezadáte, zastavení začne po dvou minutách.
sudo -E může odpojit — kontext kontextové jméno	Odpojte komponenty přidružené ke clusteru. Ke spuštění tohoto příkazu potřebujete oprávnění sudo root. Tento příkaz nabízí následující možnosti:   • kontext kontextové jméno– Název clusteru Kubernetes, který se má odinstalovat. Zadejte název clusteru.

Název příkazu

Akce

av verze [–kontext kontextové jméno] [-o|– výstupní json] [–detail]

Zobrazuje verzi následujícího:   • Každá běžící mikroslužba v instanci Broadband Edge Event Collection a Visualization.   • Nástroj Broadband Edge Event Collection and Visualization.   • Všechny dostupné verze softwaru Broadband Edge Event Collection a Visualization v systému.   Tento příkaz nabízí následující možnosti:   • kontext kontextové jméno– Název clusteru Kubernetes. Zadejte název clusteru.   • output (výstup) – umožňuje požádat o výstup ve formátu JSON.   • detail – Zobrazuje všechny dostupné verze softwaru.

K zadání příkazu použijte následující obecnou syntaxi

• Pro krátkou možnost:

• Pro dlouhou variantu:

• Chcete-li zobrazit seznam dostupných příkazů se stručným popisem, použijte volbu h nebo help:

• Chcete-li zobrazit možnosti pro konkrétní příkaz:

Spusťte Broadband Edge Event Collection a vizualizační služby

• Pomocí skriptu místního nástroje spusťte všechny služby BBE Event Collection a Visualization.
• Provedením tohoto příkazu spustíte všechny služby BBE Event Collection a Visualization:

POZNÁMKA: Nedoporučujeme zastavovat služby BBE Event Collection a Visualization.

Zkontrolujte stav služby Broadband Edge Event Collection a vizualizace

• Pomocí skriptu ecav status utility zkontrolujte stav služby BBE Event Collection and Visualization. Stav může ukazovat, zda je služba spuštěna či nikoli.
• Chcete-li zkontrolovat podrobné informace o službě, spusťte následující příkaz:

Napřample

Odinstalujte a odeberte Broadband Edge Event Collection and Visualization
Pomocí skriptu nástroje ecav odinstalujte konfiguraci BBE Event Collection a Visualization. Příkaz clean odinstaluje a odebere všechny verze BBE Event Collection a Visualization z vašeho systému.
Odinstalování BBE Event Collection and Visualization:

1. Na hostiteli skoku, kde jste nainstalovali BBE Event Collection and Visualization, spusťte příkaz stop.
2. Spusťte příkaz pro odpojení.
3. Spusťte příkaz clean.

KONTAKT

• Společnost Juniper Networks, Inc.
• 1133 Inovační cesta
• Sunnyvale, Kalifornie 94089
• USA
• 408-745-2000
• www.juniper.net

Juniper Networks, logo Juniper Networks, Juniper a Junos jsou registrované ochranné známky společnosti Juniper Networks, Inc.
ve Spojených státech a dalších zemích. Všechny ostatní ochranné známky, servisní známky, registrované známky nebo registrované servisní známky jsou majetkem příslušných vlastníků.
Juniper Networks nepřebírá žádnou odpovědnost za jakékoli nepřesnosti v tomto dokumentu. Juniper Networks si vyhrazuje právo změnit, upravit, převést nebo jinak revidovat tuto publikaci bez upozornění.
Broadband Edge Event Collection and Visualization Instalační příručka Copyright © 2023 Juniper Networks, Inc. Všechna práva vyhrazena.
Informace v tomto dokumentu jsou aktuální k datu na titulní straně.

OZNÁMENÍ K ROKU 2000
Hardwarové a softwarové produkty Juniper Networks jsou v souladu s rokem 2000. Junos OS nemá žádná známá časová omezení do roku 2038. Je však známo, že aplikace NTP bude mít v roce 2036 určité potíže.

LICENČNÍ SMLOUVA S KONCOVÝM UŽIVATELEM
Produkt Juniper Networks, který je předmětem této technické dokumentace, se skládá ze softwaru Juniper Networks (nebo je s ním určen). Používání takového softwaru podléhá ustanovením a podmínkám Licenční smlouvy s koncovým uživatelem („EULA“) zveřejněné na adrese https://support.juniper.net/support/eula/. Stažením, instalací nebo používáním takového softwaru souhlasíte s podmínkami dané EULA.

Dokumenty / zdroje

Juniper NETWORKS Broadband Edge Event Collection a vizualizace [pdfUživatelská příručka Broadband Edge Event Collection and Visualization, Broadband Edge, Event Collection and Visualization, Collection and Visualization

Reference

• Uživatelská příručka