Ajánlott elemzési eljárások

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Az Elemzés az Azure DevOps jelentéskészítési platformja, amely lehetővé teszi, hogy elemzéseket nyerjen az adatokból, és adatvezérelt döntéseket hozzon. Az Elemzés gyors olvasási és kiszolgálóalapú összesítésekhez van optimalizálva, és különböző eszközöket biztosít az adatok vizualizációjához és elemzéséhez. Ebben a cikkben bemutatunk néhány ajánlott eljárást az Analytics Azure DevOpsban való használatához.

Előfeltételek

  • Az Analytics-adatok megtekintéséhez és a szolgáltatás lekérdezéséhez egy alapszintű hozzáféréssel rendelkező vagy annál nagyobb hozzáférésű projekt tagjának kell lennie. Alapértelmezés szerint minden projekttag rendelkezik az Analytics lekérdezéséhez és az Analytics-nézetek meghatározásához szükséges engedélyekkel.
  • A szolgáltatás- és szolgáltatás-engedélyezéssel, valamint az általános adatkövetési tevékenységekkel kapcsolatos egyéb előfeltételekről az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben olvashat.

Ismerkedés az Analytics metaadataival

Az Analytics metaadatainak lekérdezésével megismerheti az entitástípusokat, az entitáskészleteket, a tulajdonságokat és az enumerált listákat. További információ: Az Elemzési szolgáltatás lekérdezése, az Analytics OData metaadatai, valamint az Azure Boards entitásainak és tulajdonságainak referenciája.

A lekérdezés strukturálása a szükséges adatok visszaadásához

A jelentés létrehozásához szükséges minimális adatkészlet lekérdezéséhez kövesse az alábbi eljárásokat:

Válassza ki azt az entitáskészletet, amely támogatja a jelentést

Bár az Analytics-adatmodell számos EntitySets támogatott, csak néhányat használ a jelentések létrehozásához.EntitySets a jelentések készítéséhez használt három kategóriába tartozik:

  • Aktuális: A tároló aktuális konfigurációjára vonatkozó információkat tartalmaz a EntityTypesEntitySet.
  • Pillanatkép: Összetett entitások, amelyek az előzményekkel és a dátummal kapcsolatos adatokat kombinálják. A pillanatkép-entitások az összesítő jelentések támogatására szolgálnak.
  • Változat: Előzményadatokat tartalmaz. Például WorkItemRevision a munkaelemek előzményeiről tart fenn adatokat.

Íme egy rövid útmutató az EntityTypes beállításához a jelentések támogatásához. Ezeknek az EntityType-oknak a leírását az Analytics adatmodellje ismerteti.

Azure DevOps-adatok Aktuális Pillanatkép Változat
Azure Boards WorkItems WorkItemSnapshot
WorkItemBoardSnapshot		 WorkItemRevisions
Azure Pipelines Pipelines
PipelineTasks		 ParallelPipelineJobsSnapshot
PipelineRuns, PipelineRunActivityResults
Azure-folyamatok és tesztek TestResultsDaily TestRuns
Azure Test Plans Tests
TestConfiguration
TestPoints
WorkItems		 TestResultsDaily
TestPointHistorySnapshot

Lekérdezési részek megadása a végrehajtásuk sorrendjében

A különböző lekérdezési részek ajánlott sorrendje az, hogy a következő sorrendben adja meg őket, vagyis a kiértékelésük sorrendjében. Az egyes lekérdezési részeket az Elemzési szolgáltatás lekérdezése, lekérdezési beállítások című témakörben talál.

  1. $apply
  2. $filter
  3. $orderby
  4. $expand
  5. $select
  6. $skip
  7. $top

Minden lekérdezésnek tartalmaznia kell egy vagy $select több $apply záradékot, ellenkező esetben figyelmeztető üzenet jelenhet meg.

A lekérdezésben kért oszlopok korlátozása

A záradék használatával adja meg a visszaadni kívánt adatoszlopokat $select . A testreszabással a munkaelemekhez számos mező társítható. Minél több tulajdonságra vagy mezőre hivatkozik egy lekérdezés, annál drágább a feldolgozás. Fontolja meg a létrehozni kívánt jelentést, és győződjön meg arról, hogy csak a szükséges mezőket kéri le.

Ha például egy szűrt munkaelemcsoport azonosító, munkaelemtípus, Cím és Állapot mezőjét szeretné visszaadni, adja meg a következő $select záradékot: $select=WorkItemId, WorkItemType, Title, State

A tulajdonságok és a hozzájuk tartozó mezőnevek listájának megtekintéséhez tekintse meg az Azure Boards entitásainak és tulajdonságainak hivatkozását.

Előzetes lekérdezések létrehozása

Az előzetes lekérdezések olyan lekérdezések, amelyek egyetlen rekordot vagy a rekordok kis részhalmazát adnak vissza. Előnézeti lekérdezés létrehozásával finomíthatja a lekérdezést, így meggyőződhet arról, hogy a szükséges adatokat kéri le. A minimális lekérdezéstől kezdve létrehozhatja a lekérdezést, hogy a kívánt rekordokat és a szükséges oszlopadatokat adja meg.

A használatával apply=aggregate($count as Count)azonosíthatja a kért rekordok számát. Az alábbi szintaxis például lekérdezi a Fabrikam Fibre projekt munkaelemeinek számát.

https://analytics.dev.azure.com/content-learn/Content/_odata/v4.0-preview/WorkItems? $apply=aggregate($count as Count)

A válasz összesen 1415 munkaelemet ad vissza.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam Fbier/_odata/v4.0-preview/$metadata#WorkItems(Count)",
   "value": [
  {
     "@odata.id": null,
   "Count": 1415
  }
  ]
}

Lekérdezések korlátozása olyan projektekre, amelyekhez hozzáféréssel rendelkezik

A projekthatókörű lekérdezések egyetlen projekt adatait adnak vissza, míg a szervezeti hatókörű lekérdezések célja a projekthatárokat átlépő információk visszaadása. A szervezeti hatókörű lekérdezésekhez szélesebb körű felhasználói engedélyekre vagy gondos hatókörkezelési korlátozásokra van szükség annak érdekében, hogy a lekérdezés ne legyen blokkolva a projektengedélyek hiánya miatt.

Ha rendelkezik hozzáféréssel egy vagy több projekthez, de nem minden projekthez, és szervezeti hatókörű lekérdezést küld, hibaüzenet jelenik meg.

"VS403496: The query results include data in one or more projects for which you do not have access. Add one or more projects filters to specify the project(s) you have access to in 'WorkItems' entity. If you're using $expand or navigation properties, project filter is required for those entities. More information can be found here: https://go.microsoft.com/fwlink/?LinkId=786441."

További információkért tekintse meg a Project és a szervezet hatókörébe tartozó lekérdezéseket.

Figyelmeztetések és hibaüzenetek áttekintése

Az Analytics áttekinti az összes olyan lekérdezést, amely szabálysértéseket kap. Figyelmeztető üzeneteket ad vissza, amikor szabálysértést észlel. Javasoljuk, hogy tekintse át ezeket az üzeneteket a lekérdezési struktúra javítása vagy javítása érdekében.

Sebességkorlátok és szabályozás

Az Azure DevOps Serviceshez készült Analytics-lekérdezésekre díjkorlátok vonatkoznak. Ha túl sok olyan lekérdezést küld a rendszer, amely nagy mennyiségű adat visszaadását kéri rövid időn belül, a szolgáltatás szabályozás alá kerülhet. További információ: Sebesség és használati korlátok.

A szolgáltatás és az egyének használatának áttekintéséhez lépjen a Szervezeti Gépház Felhasználók lapra>, és gyakorolja a szűrőket. Az alábbi képen például Jamal Hartnett által az Analytics szolgáltatásban használt adatok láthatók.

Képernyőkép egy felhasználó és az Analytics Használati oldaláról.