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.

Not

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ışı genel kullanıma hazır. 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.0ve en son önizleme sürümü 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.

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 trendi 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.

Önkoşullar

Kategori	Gereksinimler
Erişim düzeyleri	- Project Üyesi. - En az Temel erişim.
İzinler	Varsayılan olarak, proje üyeleri Analytics'i sorgulama ve görünüm oluşturma iznine sahiptir. Hizmet ve özellik etkinleştirme ve genel veri izleme etkinlikleriyle ilgili diğer önkoşullar hakkında daha fazla bilgi için bkz. Analyticserişme izinleri ve önkoşulları.

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

WorkItemSnapshot tablosunu etkili bir şekilde sorgulamak için şu temel gereksinimleri izleyin:

• Verileri tarihe göre filtreleyin.
• Toplamayı en azından tarihe göre gruplandırın. Aksi takdirde yanıt bir uyarı içerir.

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

OData

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:

JSON

{
  "@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 fazla 31 * (number of bug states)üretir. Varsayılan hatanın üç durumu vardır:

• Etkin
• Çözülmüş
• Kapalı

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:

OData

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:

JSON

{
  "@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.

Not

Anlık görüntü tablolarındaki sorgunuz toplama kullanmıyorsa, yanıt şu uyarıyı görüntüler: "Belirtilen sorgu, tüm sorgular için önerilen bir $select veya $apply yan tümcesi içermiyor."

İlgili makaleler

• İlgili veri gruplarını saymak ve çözümlemek için toplama veri sorguları oluşturun.