Aracılığıyla paylaş

Azure Pipelines Analytics için meta veri başvurusu

  • Makale

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

Analiz hizmeti, Azure Pipelines aracılığıyla oluşturulan işlem hattı ve test etkinliğini toplar. Bu makalede, işlem hatları için bir Analytics raporu oluşturmak için kullanabileceğiniz özellikler açıklanmaktadır. Bir sorguyu filtrelemek, verileri toplamak veya rapor oluşturmak için özelliklerin birleşimini kullanırsınız.

Not

Analiz veri modeli tarafından desteklenen varlıkların, özelliklerin ve numaralandırılmış türlerin açıklamaları sağlanır. Bu erken bir taslak. Lütfen daha fazla bilgi edinmek istediğiniz alanlarla ilgili geri bildirim sağlayın. Veri modelini sorgulamak için bkz . Analiz için OData sorguları oluşturma.

Varlık kümeleri ve varlık türleri

Aşağıdaki tabloda Azure Pipelines'ı destekleyen varlık türleri ve varlık kümeleri özetlenmiştir. Tüm varlık türleri/varlık kümeleri Analytics v4.0 önizleme sürümüyle kullanılabilir. Analiz sürümü v3.0-preview anlık görüntüleri desteklemez.

EntitySet EntityType Açıklama
Şube Dal Testlerde veya işlem hatlarında kullanılan dallar hakkında temel bilgiler. Örnek rapor için bkz . İlerleme durumu örnek raporu.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Bileşik) Paralel işlem hattı tüketiminin anlaşılmasını destekler. Paralel işlem hattı testleri hakkında daha fazla bilgi için bkz . Visual Studio Test görevini kullanarak testleri paralel olarak çalıştırma.
Pipelines Ardışık düzen İşlem hattının özellikleri.
PipelineJobs PipelineJob TestRun ile ilişkili belirli bir Test için tek tek yürütme sonuçları
PipelineRuns PipelineRun İşlem hatları için yürütme bilgileri. Örnek rapor için bkz . İşlem hattı geçiş hızı eğilim örneği raporu.
PipelineRunActivityResults PipelineRunActivityResult Belirli bir işlem hattı yürütmesi içindeki tüm aşamaların, adımların, işlerin ve görevlerin birleştirilmiş günlüğü. Örnek rapor için bkz . İşlem hattı görev süresi örnek raporu.
PipelineTasks PipelineTask İşlem hattı içinde kullanılan görevlerin özellikleri.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Bileşik) Havuz boyutunun, işlem hattı işlerinin ve eşzamanlılığın anlaşılmasını destekler. Aracı havuzları için Geçmiş grafı, bu varlık kümesinin nasıl kullanılabileceğini gösterir.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Bileşik) Görev aracısı isteklerinde raporlamayı destekler.

Dallar

Aşağıdaki özellikler Dallar varlık kümesi için geçerlidir. Branch ile ilişkilendirilmiş vekil anahtarlar ve ProjectSKiçerirBranchSK.

Görünen ad Ad Veri türü Açıklama
AnalyticsUpdatedDate DateTime Analytics verilerinin en son ne zaman güncelleştirildiğini gösteren filigran.
Dal Adı BranchName String Bir dal oluşturulduğunda atanan ad.
Depo Kimliği RepositoryId String Depo oluşturulduğunda depoya atanan sayı.
Depo Vsts Kimliği RepositoryVstsId String Oluşturulduğunda TFVC deposuna atanan sayı.
RepositoryUrl RepositoryUrl String Depo oluşturulduğunda depo için tanımlanan URL.

Gezinti özellikleri ve bilgi kısıtlamasını ProjectSKiçerirProject.

ParallelPipelineJobsSnapshot

Aşağıdaki özellikler ParallelPipelineJobsSnapshot varlık kümesi için geçerlidir. Başvuru anahtarları şunlardır:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Görünen ad Ad Veri türü Açıklama
Barındırılan veya şirket içinde barındırılan IsHosted Boolean Paralel işlem hattının Microsoft tarafından barındırılan bir aracıda (True) veya şirket içinde barındırılan (False) bir aracıda çalıştırılıp çalıştırılamadığını gösterir. Daha fazla bilgi için bkz . Azure Pipelines aracıları.
Tüm Sağlayıcılara Ulaşılamadı FailedToReachAllProviders Boolean İş çalıştırmasının tüm sağlayıcılara (True) ulaşıp ulaşmadığını (False) gösterir.
Paralel İşlem Hattı İş Sayısı TotalCount Int32 Anlık görüntünün bir parçası olarak çalıştırılacak iş sayısı.
Paralel İşlem Hatlarının Dakika Sayısı TotalMinutes Int32 Anlık görüntüyü çalıştırmak için geçen dakika sayısı.
Paralellik Türü ParallelismTag String İş anlık görüntüsüyle ilişkili paralellik türünü gösteren etiket.
Premium Tür IsPremium Boolean Paralel işlem hattının premium (True) olup olmadığını (False) gösterir.
Örnek Tarih SamplingDate DateTime Anlık görüntüyle ilişkili tarih.

Pipelines

İşlem Hatları ve vekil anahtarı PipelineSKiçin aşağıdaki özellikler geçerlidir.

Görünen ad Ad Veri türü Açıklama
İşlem Hattı Kimliği PipelineId Int32 İşlem hattına atanan kimlik.
İşlem Hattı Adı PipelineName String İşlem hattına atanan ad.
İşlem Hattı Sürümü PipelineVersion Int32 İşlem hattıyla ilişkili sürüm.
İşlem Hattı İşlem Türü PipelineProcessType Enumerated İşlem hattı tanımının türü. PipelineProcessType için aşağıda geçerli değerler listelenmiştir.

Gezinti özellikleri ve bilgi kısıtlamasını ProjectSKiçerirProject.

PipelineProcessType numaralandırılmış tür üyeleri

Aşağıdaki üyeler, işlem hattını tanımlamak için kullanılan yöntemi gösteren numaralandırılmış tür için PipelineProcessType tanımlanır.

Üye adı Değer Tanım
Designer 1 Klasik işlem hattı tanımı.
Yaml 2 YAML işlem hattı tanımı.
Docker 3 Docker işlem hattı tanımı.

PipelineJobs

İşlem hattı işi, birim olarak sıralı olarak çalışan bir dizi adımdır. İş, çalışmak üzere zamanlayabileceğiniz en küçük çalışma birimidir. İşlem hatları işler etrafında düzenlenir ve her işlem hattının en az bir işi vardır. Daha fazla bilgi için, bkz. İşlem hattınızda işleri belirtme.

Aşağıdaki özellikler PipelineJobs ve PipelineJobSK vekil anahtarı için geçerlidir.

Görünen ad Ad Veri türü Açıklama
İşlem Hattı Tam İş Adı FullJobName String İşlem hattı işinin tam adı.
İşlem Hattı Kimliği PipelineId Int32 İşin tanımlandığı işlem hattına atanan kimlik.
İşlem Hattı İş Tanımlayıcısı JobId String İşlem hattı işi oluşturulduğunda atanan iş tanımlayıcısı.
İşlem Hattı İş Adı JobName String İşlem hattı işine atanan ad.
İşlem Hattı Aşama Adı StageName String İşlem hattı işiyle ilişkili aşama adı.
İşlem Hattı İş Stratejisi Öznitelikleri StrategyAttributes String İşlem hattı işi için tanımlanan öznitelikler.
Aşama Tanımlayıcısı StageId String İşlem hattı işiyle ilişkili aşama tanımlayıcısı.

Gezinti özellikleri ve bilgi kısıtlamasını ProjectSKiçerirProject.

PipelineJob varlık türünü sorgulayan örnek bir rapor için bkz. İşlem hattı aşaması akıllı hatalar örnek raporu.

PipelineRuns

İşlem hattı çalıştırması, bir işlem hattının tek bir yürütmesini temsil eder. Çalıştırma sırasında işlem hattı işlenir ve aracılar bir veya daha fazla işi işler. İşlem hattı çalıştırması işler, adımlar ve görevler içerir. Daha fazla bilgi için bkz . İşlem hattı çalıştırma sırası.

Aşağıdaki özellikler PipelineRun varlık türü ve PipelineRunSK vekil anahtarı için geçerlidir.

Görünen ad Ad Veri türü Açıklama
İptal Edilen Sayı CanceledCount Int32 İptal edilen işlem hattı çalıştırmalarının sayısı.
Tamamlanma Tarihi CompletedDate DateTime İşlem hattının yürütmeyi tamamlayacağı tarih ve saat.
Başarısız Sayı FailedCount Int32 Başarılı olan işlem hattı çalıştırmalarının sayısı.
Sayı Düzeltmesi RunNumberRevision Int32 Ardışık yürütmelerle bir işlem hattına atanan sayı çalıştırılır.
Kısmen Başarılı Sayısı PartiallySucceededCount Int32 Kısmen başarılı olan işlem hattı çalıştırmalarının sayısı.
İşlem Hattı Çalıştırma Kimliği PipelineRunId Int32 İşlem hattı çalıştırmasına atanan sayı.
Kuyruğa Alınan Tarih QueuedDate DateTime İşlem hattının çalıştırılacak kuyruğa alındığı tarih ve saat.
Kuyruk Süresi Saniyeleri QueueDurationSeconds Ondalık İşlem hattının kuyrukta kaldığı saniye sayısı.
Çalıştırma Numarası RunNumber String Bir işlem hattı çalıştırıldığında çalıştırılan numara.
Çalıştırma Sonucu RunOutcome Enumerated Yürütmesi tamamlandıktan sonra işlem hattına atanan sonuç. PipelineRunOutcome için geçerli değerler aşağıda listelenmiştir.
Çalıştırma Nedeni RunReason Enumerated İşlem hattının çalışmasına neden olan koşul. PipelineRunReason için geçerli değerler aşağıda listelenmiştir.
Çalıştırma Süresi Saniyeleri RunDurationSeconds Ondalık İşlem hattı çalıştırmasının tamamlanması için geçen saniye sayısı.
Başlangıç Tarihi StartedDate DateTime İşlem hattı çalıştırmasının başladığı tarih ve saat.
Başarılı Sayı SucceededCount Int32 Başarılı olan işlem hattı çalıştırmalarının sayısı.
Toplam Süre Saniyesi TotalDurationSeconds Ondalık İşlem hattının kuyrukta olduğu ve çalıştırıldığı toplam saniye sayısı.

Aşağıdaki gezinti özellikleri desteklenir.

Görünen ad Veri Akışı Adı -Bilgi kısıtlaması Başvurulan özellik
Dal Branch BranchSK BranchSK
Tamamlanma Tarihi CompletedOn CompletedDateSK DateSK
Kuyruğa Alındı QueuedOn QueuedDateSK DateSK
Başlangıç Tarihi StartedOn QueuedDateSK DateSK
Ardışık düzen Pipeline PipelineSK PipelineSK
Proje Project ProjectSK ProjectSK

PipelineRunReason numaralandırılmış tür üyeleri

Aşağıdaki üyeler, koşulları belirtme bölümünde açıklandığı gibi her işlem hattı aşamasının, işin veya adımın hangi koşullar altında çalıştığını gösteren numaralandırılmış tür için PipelineRunReason tanımlanır.

Üye adı Value Görünen ad
None 0 Hiçbiri
Manual 1 El ile
IndividualCI 2 Bireysel CI
BatchedCI 4 Toplu CI
Schedule 8 Zamanla
UserCreated 32 Kullanıcı Oluşturuldu
ValidateShelveset 64 Raf Kümesini Doğrula
CheckInShelveset 128 raf kümesini Kontrol
PullRequest Kategori 256 Çekme İsteği
PipelineRunCompletion 512 Derleme Tamamlama

PipelineRunOutcome numaralandırılmış tür üyeleri

İşlem hattı çalıştırmasının PipelineRunOutcome sonucunu gösteren numaralandırılmış tür için aşağıdaki üyeler tanımlanır.

Üye adı Value Görünen ad
None 0 Hiçbiri
Succeed 2 Başarılı
PartiallySucceeded 4 Kısmen Başarılı
Failed 6 Başarısız
Canceled 32 İptal edildi

PipelineRunActivityResults

Aşağıdaki özellikler PipelineRunActivityResults varlık kümesi ve vekil PipelineRunActivityResultSK anahtarı için geçerlidir.

Birçok özellik tarih tabanlı veya kullanıcı tabanlıdır. Bu özellikler Takvim tarihi, Proje ve Kullanıcı meta verileri başvurusunda açıklanan CalendarDate ve Kullanıcı varlık kümeleriyle ilişkilendirilir.

Görünen ad Ad Veri türü Açıklama
Bırakılan Sayı AbandonedCount Int32 Terk edildi olarak işaretlenmiş işlem hattı çalıştırmalarının sayısı.
Etkinlik Tamamlanma Tarihi ActivityCompletedDate DateTime İşlem hattı çalıştırmasının yürütmeyi tamamlayacağı tarih ve saat.
Etkinlik Süresi Saniyeleri ActivityDurationSeconds Ondalık İşlem hattının kuyrukta olduğu ve çalıştırıldığı toplam saniye sayısı.
Etkinlik Başlangıç Tarihi ActivityStartedDate DateTime İşlem hattı çalıştırmasının başladığı tarih-saat.
İptal Edilen Sayı CanceledCount Int32 İptal edilen işlem hattı çalıştırmalarının sayısı.
Başarısız Sayı FailedCount Int32 Başarısız olan işlem hattı çalıştırmalarının sayısı.
İşlem Hattı Etkinlik Türü ActivityType Enumerated İşlem hattı etkinliğinin türü. PipelineActivityType için aşağıda geçerli değerler listelenmiştir.
İşlem Hattı Çalıştırma Kimliği PipelineRunId Int32 Bir işlem hattı çalıştırıldığında çalıştırılan numara.
İşlem Hattı Çalıştırma Sonucu PipelineRunOutcome Enumerated Yürütmesi tamamlandıktan sonra işlem hattına atanan sonuç. Geçerli değerler PipelineRunOutcome altında listelenir.
İş Saniyelerinden Göreli Başlangıç Zamanı RelativeStartTimeFromJobSeconds Int32 İşin başlangıcından geçen saniye sayısı.
Aşama Saniyelerinden Göreli Başlangıç Zamanı RelativeStartTimeFromStageSeconds Int32 Aşamanın başlangıcından geçen saniye sayısı.
Çalıştırma Saniyelerinden Göreli Başlangıç Zamanı RelativeStartTimeFromRunSeconds Int32 Çalıştırmanın yürütülürken geçen saniye sayısı.
Atlanan Sayı SkippedCount Int32 Atlanan işlem hattı çalıştırmalarının sayısı.
Başarılı Sayı SucceededCount Int32 Başarılı olan işlem hattı çalıştırmalarının sayısı.
Sorun Sayısıyla Başarılı Oldu SucceededWithIssuesCount Int32 Kısmen başarılı olan işlem hattı çalıştırmalarının sayısı.
Görev Görünen Adı TaskDisplayName String İşlem hattı çalıştırmasında yürütülen görevin adı.
Görev Günlüğü Yolu TaskLogPath String Görev tarafından oluşturulan günlük dosyasının yolu.
Görev Sonucu TaskOutcome Özel Yürütülen görevin sonucu.

PipelineRunActivityResult varlık türünü sorgulayan örnek raporlar için bkz. İşlem hattı görev süresi eğilimi örnek raporu.

Gezinti özellikleri, aşağıdaki tabloda listelenenleri içerir.

Görünen Ad Ad Bilgi kısıtlaması Başvurulan özellik
Etkinlik Başlama Tarihi ActivityStartedOn ActivityStartedDateSK DateSK
Dal Branch BranchSK BranchSK
Ardışık düzen Pipeline PipelineSK PipelineSK
İşlem Hattı Görevi PipelineTask PipelineTaskSK PipelineTaskSK
İşlem Hattı İşi PipelineJob PipelineJobSK PipelineJobSK
Kuyruğa Alınan İşlem Hattı Çalıştırması PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
İşlem Hattı Çalıştırması Başlatıldı PipelineRunStartedOn PipelineRunStartedDateSK DateSK
İşlem Hattı Çalıştırması Tamamlandı PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
İşlem Hattı Çalıştırması Başlatıldı PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Proje Project ProjectSK ProjectSK

PipelineActivityType numaralandırılmış tür üyeleri

Numaralandırılmış tür için PipelineActivityType aşağıdaki üyeler tanımlanır.

Üye adı Value Görünen ad
Task 0 Görev
Approval 1 Onay
AgentWait 2 Aracı Bekleme

PipelineTasks

Aşağıdaki özellikler PipelineTasks varlık kümesi ve vekil anahtarı PipelineTaskSKiçin geçerlidir.

Görünen ad Ad Veri türü Açıklama
Görev Tanımı Kimliği TaskDefinitionId GUID İşlem hattı görevine atanan GUID.
Görev Tanımı Sürümü TaskDefinitionVersion String İşlem hattı görevine atanan sürüm.

Gezinti özellikleri ve bilgi kısıtlamasını ProjectSKiçerirProject.

TaskAgentPoolSizeSnapshots

Aşağıdaki özellikler TaskAgentPoolSizeSnapshots varlık kümesi ve vekil anahtarı SamplingDateiçin geçerlidir.

Görünen ad Özellik adı Veri türü Açıklama
Çevrimiçi Sayı OnlineCount Int32 Görev çalıştırıldığında aracı havuzundaki çevrimiçi aracı sayısı.
Çevrimdışı Sayı OfflineCount Int32 Görev çalıştırıldığında aracı havuzunda çevrimdışı olan aracıların sayısı.
Havuz Kimliği PoolId Int32 Aracı havuzuna atanan sayı.
Örnek Tarih SamplingDate DateTime Havuz boyutunun tutturıldığı tarih ve saat.

TaskAgentPoolSizeSnapshot varlığından oluşturulmuş örnek bir rapor için bkz. Aracı havuzları için geçmiş graf (Önizleme).

TaskAgentRequestSnapshots

Bir görev yürütülürken aracı havuzları ayrılır. TaskAgentRequestSnapshots varlık kümesi, görev aracısı istekleriyle ilgili verileri yakalar.

Aşağıdaki özellikler TaskAgentRequestSnapshot varlık türü ve vekil anahtarları SamplingTime ve SamplingDateSKiçin geçerlidir.

Görünen ad Ad Veri türü Açıklama
Kuyruğa Alınan Derleme IsQueued Boolean Derlemenin kuyruğa alındığını (True) veya kuyruğa alınmadığını (False) gösterir.
Derleme Çalışıyor IsRunning Boolean Derlemenin çalışıp çalışmadığını (True) veya çalışmadığını (False) gösterir.
Barındırılan veya şirket içinde barındırılan IsHosted Boolean Göreve atanan aracının barındırılıp barındırılamadığını (True) veya şirket içinde barındırılan (False) olduğunu gösterir.
İş Bitiş Tarihi FinishedDate DateTime Görev aracısı isteğinin çalışmasının bittiği tarih-saat.
FinishedDateSK Int32 Görev aracısı isteğinin çalışmasının bittiği tarih, kuruluş için tanımlanan saat diliminde ifade YYYYMMDD edilir.
Kuyruğa Alınan Tarih QueuedDate DateTime Görev aracısı isteğinin kuyruğa alındığı tarih-saat.
QueuedDateSK Int32 Görev aracısı isteğinin kuyruğa alındığı tarih, kuruluş için tanımlanan saat diliminde ifade YYYYMMDD edilir.
Kuyruk Süresi Saniyeleri QueueDurationSeconds Ondalık Bir aracı atanmadan önce görev aracısı isteğinin kuyrukta kaldığı saniye sayısı.
Havuz Kimliği PoolId Int32 Görev aracısı isteğine atanan aracı havuzuna atanan numara.
İşlem Hattı Türü PipelineType String Görev aracısı isteğini içeren işlem hattı türü.
İstek Kimliği RequestId Int64 Görev aracısı isteğine atanan sayı.
Örnek Saat SamplingHour Int32 İsteğin alındığı saate atanan sayı.
Örnek Saat SamplingTime DateTime Görev aracısı isteğinin alındığı tarih-saat.
Başlangıç Tarihi StartedDate DateTime Görev aracısı isteğinin yürütülürken gerçekleştirildiği tarih-saat.
StartedDateSK Int32 Görev aracısı isteğinin yürütülmeye başladığı tarih, kuruluş için tanımlanan saat diliminde ifade YYYYMMDD edilir.

Gezinti özellikleri, aşağıdaki tabloda listelenenleri içerir.

Görünen ad Veri Akışı Adı Bilgi kısıtlaması -Başvurulan özellik
Dal Branch BranchSK BranchSK
Tamamlanma Tarihi CompletedOn CompletedDateSK DateSK
İş Bitiş Saati FinishedOn FinishedDateSK DateSK
Kuyruğa Alındı QueuedOn QueuedDateSK DateSK
Ardışık düzen Pipeline PipelineSK PipelineSK
Proje Project ProjectSK ProjectSK
Başlangıç Tarihi StartedOn QueuedDateSK DateSK