Naplók lekérése IoT Edge-beli üzemelő példányokból

A következőkre vonatkozik: IoT Edge 1.5

Az IoT Edge-ügynökmodulban található közvetlen módszerekkel lekérheti a naplókat az IoT Edge-környezetekből anélkül, hogy fizikai vagy SSH-hozzáférésre van szüksége az eszközhöz. A közvetlen metódusok implementálva vannak az eszközön, majd meghívhatók a felhőből. Az IoT Edge-ügynök közvetlen metódusokat tartalmaz, amelyekkel távolról monitorozhatja és kezelheti az IoT Edge-eszközöket. A cikkben tárgyalt közvetlen módszerek általában az 1.0.10-es kiadással érhetők el.

A közvetlen metódusokról, azok használatáról és a saját modulokban való implementálásukról további információt az IoT Hub közvetlen metódusainak ismertetése és meghívása című témakörben talál.

Ezeknek a közvetlen metódusoknak a neve megkülönbözteti a kis- és nagybetűket.

Ajánlott naplózási formátum

Bár nem kötelező, a funkcióval való legjobb kompatibilitás érdekében az ajánlott naplózási formátum a következő:

<{Log Level}> {Timestamp} {Message Text}

{Timestamp} a következő táblázatot kell formázni yyyy-MM-dd HH:mm:ss.fff zzz, amely {Log Level} a súlyossági szinteket a Syslog szabvány súlyossági kódjából nyeri.

Az IoT Edge Logger osztálya canonical implementációként szolgál.

Modulnaplók lekérése

Az IoT Edge-modul naplóinak lekéréséhez használja a GetModuleLogs közvetlen metódust.

Ez a metódus a következő sémával fogadja el a JSON hasznos adatait:

    {
       "schemaVersion": "1.0",
       "items": [
          {
             "id": "regex string",
             "filter": {
                "tail": "int",
                "since": "string",
                "until": "string",
                "loglevel": "int",
                "regex": "regex string"
             }
          }
       ],
       "encoding": "gzip/none",
       "contentType": "json/text" 
    }

A naplók sikeres lekérése "állapotot" ad vissza : 200 , majd a modulból lekért naplókat tartalmazó hasznos adat, amelyet a kérésben megadott beállítások szűrnek.

Példa:

az iot hub invoke-module-method --method-name 'GetModuleLogs' -n <hub name> -d <device id> -m '$edgeAgent' --method-payload \
'
    {
       "schemaVersion": "1.0",
       "items": [
          {
             "id": "edgeAgent",
             "filter": {
                "tail": 10
             }
          }
       ],
       "encoding": "none",
       "contentType": "text"
    }
'

Az Azure Portalon hívja meg a metódust a metódus nevével GetModuleLogs és a következő JSON hasznos adatokkal:

    {
       "schemaVersion": "1.0",
       "items": [
          {
             "id": "edgeAgent",
             "filter": {
                "tail": 10
             }
          }
       ],
       "encoding": "none",
       "contentType": "text"
    }

A parancssori felület kimenetét Linux-segédprogramok( például gzip) is futtathatja a tömörített válasz feldolgozásához. Példa:

az iot hub invoke-module-method \
  --method-name 'GetModuleLogs' \
  -n <hub name> \
  -d <device id> \
  -m '$edgeAgent' \
  --method-payload '{"contentType": "text","schemaVersion": "1.0","encoding": "gzip","items": [{"id": "edgeHub","filter": {"since": "2d","tail": 1000}}],}' \
  -o tsv --query 'payload[0].payloadBytes' \
  | base64 --decode \
  | gzip -d

Modulnaplók feltöltése

A közvetlen UploadModuleLogs metódussal elküldheti a kért naplókat egy adott Azure Blob Storage-tárolóba.

Ez a metódus a GetModuleLogshoz hasonló JSON hasznos adatokat fogad el a "sasUrl" kulcs hozzáadásával:

    {
       "schemaVersion": "1.0",
       "sasUrl": "Full path to SAS URL",
       "items": [
          {
             "id": "regex string",
             "filter": {
                "tail": "int",
                "since": "string",
                "until": "string",
                "loglevel": "int",
                "regex": "regex string"
             }
          }
       ],
       "encoding": "gzip/none",
       "contentType": "json/text" 
    }

A naplók feltöltésére irányuló sikeres kérés "állapotot" ad vissza: 200 , majd egy hasznos adat a következő sémával:

    {
        "status": "string",
        "message": "string",
        "correlationId": "GUID"
    }

Példa:

Az alábbi meghívás az összes modulból feltölti az utolsó 100 naplósort tömörített JSON formátumban:

az iot hub invoke-module-method --method-name UploadModuleLogs -n <hub name> -d <device id> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "sasUrl": "<sasUrl>",
        "items": [
            {
                "id": ".*",
                "filter": {
                    "tail": 100
                }
            }
        ],
        "encoding": "gzip",
        "contentType": "json"
    }
'

Az alábbi meghívás az edgeAgent és az edgeHub utolsó 100 naplósorát tölti fel a tempSensor modul utolsó 1000 naplósorával tömörítetlen szöveges formátumban:

az iot hub invoke-module-method --method-name UploadModuleLogs -n <hub name> -d <device id> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "sasUrl": "<sasUrl>",
        "items": [
            {
                "id": "edge",
                "filter": {
                    "tail": 100
                }
            },
            {
                "id": "tempSensor",
                "filter": {
                    "tail": 1000
                }
            }
        ],
        "encoding": "none",
        "contentType": "text"
    }
'

Az Azure Portalon hívja meg a metódust a metódus nevével UploadModuleLogs és a következő JSON hasznos adatokkal, miután az adatokkal feltölti a sasURL-t:

    {
       "schemaVersion": "1.0",
       "sasUrl": "<sasUrl>",
       "items": [
          {
             "id": "edgeAgent",
             "filter": {
                "tail": 10
             }
          }
       ],
       "encoding": "none",
       "contentType": "text"
    }

Támogatási csomag diagnosztikáinak feltöltése

Az UploadSupportBundle közvetlen metódussal csomagolhatja és feltöltheti az IoT Edge-modulnaplók zip-fájlját egy elérhető Azure Blob Storage-tárolóba. Ez a közvetlen metódus futtatja a parancsot az iotedge support-bundle IoT Edge-eszközön a naplók lekéréséhez.

Ez a metódus a következő sémával fogadja el a JSON hasznos adatait:

    {
        "schemaVersion": "1.0",
        "sasUrl": "Full path to SAS url",
        "since": "2d",
        "until": "1d",
        "edgeRuntimeOnly": false
    }

A naplók feltöltésére irányuló sikeres kérelem "állapotot" ad vissza: 200 , amelyet egy hasznos adat követ ugyanazzal a sémával, mint az UploadModuleLogs válasz:

    {
        "status": "string",
        "message": "string",
        "correlationId": "GUID"
    }

Példa:

az iot hub invoke-module-method --method-name 'UploadSupportBundle' -n <hub name> -d <device id> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "sasUrl": "Full path to SAS url",
        "since": "2d",
        "until": "1d",
        "edgeRuntimeOnly": false
    }
'

Az Azure Portalon hívja meg a metódust a metódus nevével UploadSupportBundle és a következő JSON hasznos adatokkal, miután az adatokkal feltölti a sasURL-t:

    {
        "schemaVersion": "1.0",
        "sasUrl": "Full path to SAS url",
        "since": "2d",
        "until": "1d",
        "edgeRuntimeOnly": false
    }

Feltöltési kérelem állapotának lekérése

A GetTaskStatus közvetlen metódus használatával lekérdezheti a feltöltési naplókra vonatkozó kérések állapotát. A GetTaskStatus-kérelem hasznos adatai a correlationId feltöltési naplók kérését használják a tevékenység állapotának lekéréséhez. A correlationId rendszer az UploadModuleLogs közvetlen metódushívásra válaszul adja vissza.

Ez a metódus a következő sémával fogadja el a JSON hasznos adatait:

    {
      "schemaVersion": "1.0",
      "correlationId": "<GUID>"
    }

A naplók feltöltésére irányuló sikeres kérelem "állapotot" ad vissza: 200 , amelyet egy hasznos adat követ ugyanazzal a sémával, mint az UploadModuleLogs válasz:

    {
        "status": "string",
        "message": "string",
        "correlationId": "GUID"
    }

Példa:

az iot hub invoke-module-method --method-name 'GetTaskStatus' -n <hub name> -d <device id> -m '$edgeAgent' --method-payload \
'
    {
      "schemaVersion": "1.0",
      "correlationId": "<GUID>"
    }
'

Az Azure Portalon hívja meg a metódust a metódus nevével GetTaskStatus és a következő JSON hasznos adatokkal, miután feltölti a GUID-t az adataival:

    {
      "schemaVersion": "1.0",
      "correlationId": "<GUID>"
    }

Következő lépések

Az IoT Edge-ügynök és az IoT Edge Hub-modul ikerpéldányainak tulajdonságai