Eğilim verilerini sorgulama

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Verilerdeki eğilimleri incelemek ve dönem içi karşılaştırmalar yapmak raporlama ve veri analizinin önemli yönleridir. Analiz bu özellikleri destekler.

Dekont

Analiz hizmeti, tüm Azure DevOps Services için üretimde otomatik olarak etkinleştirilir ve desteklenir. Power BI tümleştirmesi ve Analiz Hizmeti'nin OData akışına erişim genel olarak kullanılabilir. Bunu kullanmanızı ve bize geri bildirim göndermenizi öneririz. Kullanılabilir veriler sürüme bağlıdır. Desteklenen en son sürüm, v2.0en son önizleme sürümü ise sürümüdür v4.0-preview. Daha fazla bilgi için bkz . OData API sürümü oluşturma.

Eğilim verileri WorkItemSnapshot ve WorkItemBoardSnapshot varlık kümelerinde kullanıma sunulur. Oluşturuldukları günden bugüne kadar her iş öğesi her gün için var olacak şekilde oluşturulur. Bir yıl önce oluşturulmuş yalnızca bir iş öğesi olan bir kuruluş için bu varlıkta 365 satır vardır. Büyük projelerde bu varlıkların istemci araçlarıyla kullanılması pratik olmaz.

Çözüm nedir? Toplama Uzantılarını kullanın.

Bu makalede şunları öğreneceksiniz:

• Eğilim verileri için temel bir sorgu oluşturma

OData Toplama Uzantıları'nı kullanarak Azure DevOps'tan toplanan ve raporlamaya dayanıklı veriler döndürebilirsiniz. Örneğin, Mart ayı için hata eğilimi gösterebilirsiniz. Hata eğilimleri, herhangi bir projeyi yönetmenin yaygın ve kritik bir parçasıdır, bu nedenle hemen iyi kullanıma geçirebilirsiniz.

Eğilim verileri için temel bir sorgu oluşturma

WorkItemSnapshot tablosunu etkili bir şekilde sorgulamak için ihtiyacınız olan bazı temel gereksinimler vardır:

• Verileri tarihe göre filtreleyin.
• Toplama en azından tarihe göre gruplandırılmalıdır. Aksi takdirde yanıtta uyarı olur.

Hata eğilimi raporu oluşturma sorgusu aşağıdaki örneğe benzer:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//WorkItemSnapshot?
  $apply=
    filter(DateValue ge 2016-03-01Z and DateValue le 2016-03-31Z and WorkItemType eq 'Bug')/
    groupby((DateValue,State), aggregate($count as Count))
  &$orderby=DateValue

Aşağıdaki örneğe benzer bir sonuç döndürür:

{
  "@odata.context": "https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//$metadata#WorkItemSnapshot(DateValue,State,Count)",
  "value": [
    {
      "@odata.id": null,
      "State": "Active",
      "DateValue": "2016-03-01T00:00:00-08:00",
      "Count": 2666
    },
    {
      "@odata.id": null,
      "State": "Closed",
      "DateValue": "2016-03-01T00:00:00-08:00",
      "Count": 51408
    }
  ]
}

Bu sorgu en 31 * (number of bug states)çok oluşturur. Varsayılan hatanın üç durumu vardır:

• Etkin
• Çözümlendi
• Closed

Bu sorgu, gerçekte kaç bin kayıt olursa olsun en fazla 93 satır döndürür. Çok daha küçük bir veri döndürme biçimi sağlar.

Şimdi bu örnekteki bir varyasyona bakalım. Bir yinelemeyle başlayıp başka bir yinelemeyle biten bir yinelemenin veya yayının hata eğilimini görmek istiyorsunuz.

Bu sorguyu oluşturmak için aşağıdaki örneği yapın:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//WorkItemSnapshot?
  $apply=
    filter(WorkItemType eq 'Bug')/
    filter(Iteration/IterationName eq 'Sprint 99')/
    filter(DateValue ge Iteration/StartDate and (Iteration/EndDate eq null or DateValue le Iteration/EndDate))/
    groupby((DateValue, State), aggregate($count as Count))
  &$orderby=DateValue

Aşağıdaki örneğe benzer bir sonuç döndürür:

{
  "@odata.context": "https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//$metadata#WorkItemSnapshot(DateValue,State,Count)",
  "value": [
    {
      "@odata.id": null,
      "State": "Active",
      "DateValue": "2016-04-04T00:00:00-07:00",
      "Count": 320
    },
    {
      "@odata.id": null,
      "State": "Closed",
      "DateValue": "2016-04-04T00:00:00-07:00",
      "Count": 38
    }
  ]
}

Bu sorguda iki önemli fark vardır. Verileri belirli bir yinelemeye göre filtrelemek için bir filter yan tümcesi ekledik ve tarihler artık yineleme başlangıç ve bitiş tarihleriyle sabit kodlanmış bir tarihle karşılaştırılıyor.

Dekont

Sorgunuzda anlık görüntü tablolarında toplama kullanılmazsa, yanıtta "Belirtilen sorgu, tüm sorgular için önerilen bir $select veya $apply yan tümcesi içermiyor" uyarısını görürsünüz.

İlgili makaleler

• İlgili veri gruplarını saymak ve analiz etmek için toplu veri sorguları oluşturun.