Parancs visszatérési kódjának megfigyelése

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

  1. 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.
  2. Az Adatforrások területen kattintson a Parancs visszatérési kód elemre.
  3. Kattintson a Tovább gombra.
  4. 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.
  5. 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.
    1. 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.
    2. Í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:
      1. Windows parancs esetén a parancs teljes nevét be kell írnia. Például: futtatandó_parancs.bat, és nem csak futtatandó_parancs.
      2. Tegye idézőjelek közé a nevet, hogy azt ne értelmezze a parancsértelmező. Például az ez egy teszt.batargumentumot írja be, és ne az ez egy teszt.bat argumentumot.
      3. 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.
    3. A Parancsinformációk ablak Visszatérési kódok területén kattintson a Hozzáadás gombra.
    4. 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

    5. Í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.
    6. 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:
      1. 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.
      2. 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.
    7. 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.
    8. Adjon meg egy szöveget, amely az új üzenet jelentését írja le az Üzenet szövege mezőben.
    9. Kattintson az OK gombra.
      Megnyílik az Üzenetek (lista) ablak megjelenítve az üzeneteket.
    10. 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.
    11. 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.
    12. Kattintson az OK gombra a Visszatérési kód meghatározása ablakban.
    13. 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.
    14. 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).
    15. 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.
  6. 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.
    1. 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.
    2. 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
    3. Í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.
    4. 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:
      1. 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.
      2. 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.
    5. 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.
    6. Kattintson az OK gombra.
    7. 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.
    8. 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.
    9. 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.