Meghatározhat egy adatforrást az alkalmazások vagy rendszerek megfigyeléséhez
a parancs visszatérési kódjának használatával.
Az ügynök futtatja a parancsot, összegyűjti a visszatérési kódot,
majd hozzáadja az eredményt a Rendelkezésre állás adathalmazhoz.
Erről a feladatról
Kódot a felhasználó által létrehozott parancsfájl, végrehajtható fájl,
lekérdezés vagy rendszerparancs adhat vissza. A parancs visszatérési kódja egy
alkalmazás-specifikus mechanizmus az alkalmazás vagy a megfigyelt
rendszer elérhetőségének vizsgálatára. Az ügynök futtatja a megadott parancsot és a
visszatérési kódból meghatározza a megfigyelt
alkalmazás vagy rendszer állapotát.
A parancsnak egyedi visszatérési
kódot kell biztosítania az egyes jellemző állapotok számára. A parancsnak
továbbá meg kell határoznia egy az ügynök által ezen visszatérési kódok
esetén használt üzenetet. Előfordulhat, hogy a parancs környezeti és konfigurációs változókat használ
a felhasználó által létrehozott parancsfájlon, végrehajtható fájlon, lekérdezésen, illetve
rendszerparancson belül. A parancs nem használhat környezeti, illetve konfigurációs változókat
a parancs parancssorból történő indításához, és mindössze a következő
kivételek állnak rendelkezésre: AGENT_BIN_DIR, AGENT_ETC_DIR, AGENT_LIB_DIR, CANDLE_HOME, illetve CANDLEHOME.
Eljárás
- Az Ügynök kezdeti adatforrása oldal vagy
az Adatforrás helye oldal Megfigyelési adatkategóriák területén válassza a Parancs vagy parancsfájl lehetőséget.
- Az Adatforrások területen kattintson a Parancs visszatérési kód elemre.
- Kattintson a Tovább gombra.
- A Parancs visszatérési kódja oldalon a Parancs visszatérési kód információk területre írja be a megjelenő
nevet.
- A következő részlépések végrehajtásával határozza meg és írja
le azokat a parancssorokat, amelyeket a parancs visszatérési kódja használni fog.
Megjegyzés: Határozzon meg egy parancsot az ügynök által támogatott minden egyes
operációs rendszerhez.
A parancsok megoszthatóak, de az összes parancshoz tartozó operációs
rendszerei teljes számának meg kell egyeznie az ügynök által
támogatott operációs rendszerek számával.
- A Parancs visszatérési kódja ablak Parancsok területén kattintson a Hozzáadás lehetőségre
a Parancsinformációk ablak megnyitásához.
- Írjon be egy parancssort, és válasszon egy operációs
rendszert a Parancsinformációk ablak
Operációs rendszerek területén található listából.
Megjegyzés:
- Windows
parancs esetén a parancs teljes nevét be kell írnia. Például: futtatandó_parancs.bat, és nem csak futtatandó_parancs.
- Tegye idézőjelek közé a nevet, hogy azt ne értelmezze a
parancsértelmező. Például az
ez egy
teszt.bat
argumentumot írja be, és ne az ez egy teszt.bat argumentumot.
- Parancs módosításához kattintson a parancsra és a
Szerkesztés gombra, törléséhez pedig az
Eltávolítás gombra.
- A Parancsinformációk ablak Visszatérési kódok területén kattintson a Hozzáadás gombra.
- Válasszon ki egy visszatérési kód típust a Visszatérési
kód meghatározása ablakban megjelenített listából.
A következő állapotokat rendelheti hozzá a teszt visszatérési kódokhoz:
MÁR_FUT
FÜGGŐSÉG_NEM_FUT
ÁLTALÁNOS_HIBA
NEM_FUT
OK
ELŐFELTÉTEL_NEM_FUT
FIGYELMEZTETÉS
- Írjon be egy számértéket a kiválasztott visszatérési kód
típusa számára.
A visszatérési kód érték egy egész szám, amely
egy megadott visszatérési kódot határoz meg a parancs visszatérési kódjaként. Az operációs rendszerek
közötti hordozhatóság érdekében a 0–255
tartományban szereplő visszatérési kód értéket használjon. Csak Windows rendszeren futó parancs esetén a visszatérési kód értéke -2147483648 és 2147483647 között lehet.
- Minden egyes visszatérési kódhoz adjon meg egy üzenetet,
hogy az üzenet és a kód együtt jelenjen meg. Kattintson a Böngészés gombra az
üzenetszöveg beállításához.
Az üzenet ablak felsorolja az
ügynökben meghatározott üzeneteket. Megnyílik az
Üzenetek (lista) ablak.
Megjegyzés:
- A korábban beírt szövegeket kiválaszthatja az üzenetszöveg listáról a
Tallózás gombra kattintás helyett.
Ezután folytassa az 5k lépéssel.
- A lista üres marad, amíg nem határoz meg üzeneteket. A Szerkesztés gomb segítségével módosíthat
egy meghatározott üzenetet, az Eltávolítás gombbal
pedig korábban megadott üzeneteket törölhet.
- Az Üzenetek (lista) ablakban kattintson
a Hozzáadás gombra
Megnyílik az
Üzenet meghatározása ablak.
Megjegyzés: Az üzenetazonosító automatikusan előállításra
kerül.
- Adjon meg egy szöveget, amely az új üzenet
jelentését írja le az Üzenet szövege mezőben.
- Kattintson az OK gombra.
Megnyílik az Üzenetek (lista)
ablak megjelenítve az üzeneteket.
- Az üzenet ellenőrzéséhez és véglegesítéséhez jelölje ki azt a listában, és
kattintson az OK gombra.
Az új visszatérési kód típusa, értéke és szövege a Visszatérési kód meghatározása ablakban jelenik meg.
- Ha azt szeretné, hogy ez a visszatérési kód elérhető legyen
ehhez a parancs visszatérési
kódhoz kapcsolódó más operációs rendszerekben szereplő parancsok számára, akkor válassza a Globális visszatérési kód, az összes parancsra vonatkozik lehetőséget.
Ha azt szeretné, hogy ez a visszatérési kód csak ezen parancs számára
legyen elérhető, akkor hagyja a Helyi visszatérési kód, csak erre a parancsra vonatkozik lehetőséget kijelölve.
- Kattintson az OK gombra a Visszatérési
kód meghatározása ablakban.
- Adjon meg legalább két visszatérési kódot a Parancsinformációk ablak elhagyása előtt. Egy visszatérési kódot
a problémamentes elérhetőség jelzésére, és egy másikat annak jelzésére, hogy
probléma történt.
Térjen vissza a c lépéshez, ha másik visszatérési kódot is hozzá kíván adni.
- Választható: A Parancsinformációk ablak Parancsfájlok területén kattintson a Hozzáadás
elemre az ügynök által futtatandó parancsfájlok vagy végrehajtható fájlok
kiválasztásához.
Az ügynök projektmappájába másolt fájl vagy fájlok
a
scripts/operációs rendszer alatt,
ahol az
operációs rendszer egy olyan változó, amely
attól függ, hogy mit választott ki az
operációs rendszerek
területen a
Parancsinformációk ablakban. A rendszer ezeket a fájlokat is becsomagolja és
az ügynökkel együtt terjeszti. Ha szerkeszteni kívánja a már meglévő
parancsfájl definícióját vagy az eredeti parancsfájlt a projektbe
történő bemásolása után, akkor válassza ki a fájlt, majd kattintson a
Szerkesztés gombra.
Lásd: (
Parancsfájl-definíció szerkesztése).
- Kattintson az OK gombra a Parancsinformációk
ablakban.
Megjegyzés: A parancsfájl táblázatban adhatja meg azokat a külső
fájlokat, amelyeket bele szeretne foglalni az ügynök csomagba. Ezek a
fájlok átmásolásra kerülnek a projektkönyvtárba, és az ügynökkel együtt
lesznek csomagolva a terjesztéshez.
- Ha rendelkezik még nem definiált visszatérési kódokkal, akkor
definiálja és írja le a globális visszatérési kódokat, amelyeket a parancs visszatérési
kódja használhat.
- Kattintson a Hozzáadás elemre a Globális visszatérési kódok területen a Parancs visszatérési kódja oldalon.
Megjegyzés: Az itt meghatározott visszatérési kódok globálisak. Ez azt jelenti, hogy a visszatérési kódok a parancsvisszatérési kódhoz definiált összes parancs számára
megfelelőek.
(Nincsenek
megosztva a parancs visszatérési kódok közt). Visszatérési kódokat továbbá
parancsinformációk megadása során is megadhat. Az itt megadott visszatérési kódok globálisak vagy helyiek
lehetnek. A helyi visszatérési kódok csak erre az adott parancsra
vonatkoznak. Ez a hierarchia akkor hasznos, ha
olyan visszatérési kóddal rendelkezik, amelyik ugyanaz az összes operációs rendszeren. (Ha például
egy visszatérési kód 0, az azt jelenti, hogy minden megfelelően működik. Ezt megadhatja a globális szinten, és ezután az összes megadott
parancs így értelmezi a 0 értéket.) Ha egyetlen másik operációs rendszer
sem ad vissza 5-ös visszatérési kódot, akkor az 5-ös visszatérési kódot megadhatja csak a Windows parancs számára.
Ha ugyanazt
a visszatérési kódot határozza meg a helyi parancs szinten, amit korábban
már megadott a globális szinten, akkor a parancs szinten megadott érték lesz felhasználva. Ez a módszer arra is
használható, hogy bizonyos operációs rendszereken felülírja a visszatérési kódokat.
Abban az esetben például, ha a 2-es
visszatérési kód minden UNIX operációs
rendszeren egy dolgot jelent, azonban Windows rendszereken ettől eltérő jelentése van. A
2-es visszatérési kódot globális szinten definiálhatja, mint a UNIX operációs rendszerektől elvárt értéket. Majd a
Windows
parancsban átdefiniálhatja a 2-es visszatérési kódot a
Windows
jelentésnek megfelelően.
- Válasszon ki egy visszatérési kód típust a Visszatérési
kód meghatározása ablakban megjelenített listáról.
A következő állapotokat rendelheti hozzá a teszt visszatérési kódokhoz:
MÁR_FUT
FÜGGŐSÉG_NEM_FUT
ÁLTALÁNOS_HIBA
NEM_FUT
OK
ELŐFELTÉTEL_NEM_FUT
FIGYELMEZTETÉS
- Írjon be egy számértéket a kiválasztott visszatérési kód
típusa számára. A visszatérési kód érték egy egész szám, amely
egy megadott visszatérési kódot határoz meg a parancs visszatérési kódjaként.
- Kattintson a Tallózás gombra az üzenetszöveg és
a hozzá tartozó jelentés beállításához. Minden egyes visszatérési kódhoz meg kell adnia egy üzenetet,
hogy az üzenet és a kód együtt jelenjen meg.
Az Üzenetek ablak felsorolja az ügynökben meghatározott
üzeneteket.
Megjegyzés:
- A lista üres marad, amíg nem határoz meg üzeneteket. A Szerkesztés gomb segítségével módosíthat egy megadott üzenetet, az Eltávolítás gombbal pedig törölhet megadott üzeneteket.
- A korábban beírt szövegeket kiválaszthatja az
Üzenet szövege listában, ahelyett, hogy a Tallózás
gombra kattintana. Ezután folytassa a 6h lépéssel.
- Az Üzenetek (lista) ablakban kattintson
a Hozzáadás gombra az Üzenet meghatározása ablak megjelenítéséhez, amelyben beírhatja az új
üzenet jelentését leíró szöveget.
- Kattintson az OK gombra.
- Megnyílik az Üzenetek (lista)
ablak az új üzenettel. Az üzenet ellenőrzéséhez és véglegesítéséhez jelölje ki azt a listában, és
kattintson az OK gombra.
- Amikor az új szöveg, típus és érték
megjelenik a Visszatérési kód meghatározása ablakban,
kattintson az OK gombra.
- A Parancs visszatérési kódja oldalon, miután befejezte a visszatérési
kódok és parancsok megadását az összes támogatott operációs rendszer
számára, tegye a következők egyikét:
- Ha az Új ügynök varázslót használja, akkor kattintson a Tovább lehetőségre, vagy kattintson a Befejezés gombra az
adatforrás mentéséhez és az Ügynökszerkesztő megnyitásához.
- Ha az Új ügynök összetevő varázslót használja, akkor kattintson a Befejezés gombra az Ügynökszerkesztőhöz való visszatéréshez.
Mi a következő lépés?
Ha az adatokat ebből az adatforrásból szeretné használni
az IBM® Cloud Application
Performance Management összegzési műszerfalán,
akkor hozzon létre egy szűrt adathalmazt (attribútumcsoportot) a Rendelkezésre állás
adathalmaz alapján, majd állítsa be, mintha egyetlen sort adna meg.
A NAME mező használatával válassza ki a sort a folyamathoz. Az új
szűrt attribútumcsoportban válassza ki az Állapot mezőt, majd adja meg
hozzá a súlyossági értékeket.
Útmutatásért tekintse meg a következőt: