Tarım için Azure Data Manager günlüğü

Tarım için Veri Yöneticisi kaynak örneği oluşturduktan sonra, kaynaklarınıza nasıl ve ne zaman ve kim tarafından erişilir izleyebilirsiniz. Veri düzlemi isteklerinin başarısız olmasının nedenlerinde de hata ayıklayabilirsiniz. Bunu yapmak için Tarım için Azure Data Manager'da günlüğe kaydetmeyi etkinleştirmeniz gerekir. Daha sonra günlük bilgilerini sağladığınız depolama hesabı, olay hub'ı veya log analytics çalışma alanı gibi bir hedefe kaydedebilirsiniz.

Bu makalede, Tarım için Azure Data Manager için günlüğe kaydetmeyi ayarlama adımları sağlanır.

Günlüklerin toplanmasını etkinleştirme

Tarım hizmeti kaynağı için Veri Yöneticisi oluşturduktan sonra tanılama ayarlarına gidin ve öğesini seçin add diagnostics settings. Günlükleri toplamaya ve depolamaya başlamak için şu adımları izleyin:

1. Tanılama ayarı için bir ad belirtin.
2. Günlükleri toplamaya başlamak istediğiniz kategorileri seçin.
3. Depolama hesabından, olay hub'ından veya log analytics çalışma alanından koleksiyon için hedefi seçin.

Artık günlüklere erişmek için tanılama ayarında belirttiğiniz hedefe gidebilirsiniz. Tarım için Veri Yöneticisi işleminden 10 dakika (en fazla) sonra günlük bilgilerinize erişebilirsiniz. Çoğu durumda daha hızlıdır.

Günlüklerinizi yorumlama

Her günlük, tabloda listelenen şemayı izler. Tablo alan adlarını ve açıklamalarını içerir:

Alan adı	Açıklama
Saat	UTC olarak tarih ve saat.
resourceId	Azure Resource Manager kaynak kimliği. Günlükler için bu, Tarım için Veri Yöneticisi kaynak kimliğidir.
operationName	Belgelendiği gibi işlemin adı.
operationVersion	İstemci tarafından istenen REST API sürümü.
category	Sonuç türü.
resultType	REST API isteğinin sonucu (başarılı veya başarısız).
resultSignature	HTTP durumu.
resultDescription	Kullanılabilir olduğunda sonuç hakkında ek açıklama.
durationMs	Milisaniye cinsinden REST API'si isteğini sunmak için geçen süre.
callerIpAddress	İsteği yapan istemcinin IP adresi.
düzey	Olayın önem düzeyi (Bilgilendirme, Uyarı, Hata veya Kritik).
correlationId	Günlükleri ilişkilendirmek için kullanılabilecek isteğe bağlı bir GUID.
kimlik	REST API isteğinde sunulan belirteçten kimlik. Bu genellikle bir nesne kimliği ve uygulama kimliği ya da ikisi arasında yer alır.
konum	"Doğu ABD" gibi olayı yayan kaynağın bölgesi
Özellikler	Her operationName biri için şunları içerir: requestUri (API isteğinin URI'si), partyId(istekle ilişkili partyId, uygun olduğunda),dataPlaneResourceId (istekteki veri düzlemi kaynağını benzersiz olarak tanımlayan kimlik) ve requestBody (ApplicationAuditLogs dışındaki tüm kategoriler için ile ilişkili API çağrısının istek gövdesini operationName içerir). Kategoriden önce jobProcessesLogs bahsedilen ortak değer dışında: 1. Bu liste operationNames arasındaki alanların listesidir: jobRunType (oneTime veya periyodik olabilir), jobId (işin kimliği), initiatedBy (bir işin bir kullanıcı tarafından mı yoksa hizmet tarafından mı tetiklenmiş olduğunu gösterir). 2. Bu liste, başarısız farmOperation ile ilgili işler için alanların listesidir: farmOperationEntityId (farmOperation işi tarafından oluşturulamayan varlığın kimliği), farmOperationEntityType(oluşturulamayan varlığın türü), errorCode(iş hatası kodu), errorMessage(hata açıklaması), internalErrorCode(sağlayıcı tarafından sağlanan hata kodu), internalErrorMessage(sağlayıcı tarafından sağlanan hatanın açıklaması), providerId(Sağlayıcı kimliği).

categories Tarım için Veri Yöneticisi alanı, aşağıdaki tabloda listelenen değerlere sahip olabilir:

Kategoriler tablosu

category	Açıklama
FarmManagementLogs	Parti, Çiftlik, Alan, Mevsimsel Alan, Kırpma, CropVariety, Sezon, Ek, reçete haritaları, reçeteler, yönetim bölgeleri, bölgeler, bitki doku analizi ve besin analizleri için CRUD işlemleri için günlükler.
FarmOperationsLogs	FarmOperations veri alımı işi, ApplicationData, PlantingData, HarvestingData, TillageData için CRUD işlemleri için günlükler
SatelliteLogs	Uydu veri alımı işi için oluşturma ve alma işlemleri için günlükler
WeatherLogs	Hava durumu veri alımı işi için oluşturma, silme ve alma işlemleri için günlükler
ProviderAuthLogs	Oauth sağlayıcıları için oluşturma, güncelleştirme, silme, art arda silme, alma ve alma günlükleri. Ayrıca, oauth belirteçleri için alma, tümünü alma, art arda silme günlükleri de vardır.
JobProcessedLogs	İşlerin başarılı veya başarısız olduğunu ve başarısız olma nedenini gösteren günlükler. Kaynak art arda silme işleri, veri alımı işleri günlüklerine ek olarak, grup işlemleri ve olay işleme işleri için günlükler de içerir.
ModelInferenceLogs	Biyokütle modeli işi için oluşturma ve alma işlemleri için günlükler.
InsightLogs	İçgörüler için tüm işlemleri alma ve alma günlükleri.
ApplicationAuditLogs	Veri düzlemi kaynak oluşturma, güncelleştirme, silme ve abonelik yönetimi işlemleri gibi ayrıcalıklı eylemler için günlükler. Tam liste aşağıdaki işlem adı tablosunda yer alır.

Alan operationName değerleri Microsoft.AgFoodPlatform/resource-name/read veya write ya da delete ya da action biçimindedir.

• /write işlem adındaki sonek, kaynak-adı oluşturma veya güncelleştirme işlemine karşılık gelir
• /readişlem adındaki sonek, kaynak-adı için art arda silme işi için GET/ LIST /GET TÜM API çağrılarına veya GET durumuna karşılık gelir
• /delete sonek, kaynak adının silinmesine karşılık gelir
• /action sonek, kaynak adı için POST yöntemi çağrılarına karşılık gelir
• /processed sonek, bir işin (PUT yöntemi çağrısı) tamamlanmasına karşılık gelir. Bu, işin durumunu (başarı veya başarısızlık) gösterir.
• /failures soneki, bir grup işlemi işinin (PUT yöntemi çağrısı) başarısız olmasına karşılık gelir ve hatanın nedeni hakkında açıklama içerir.

İşler için sıfat aşağıdaki gibidir:

• Veri alımı işleri için: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
• Silme işleri için: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write

Aşağıdaki tabloda, bir kategori için operationName değerleri ve buna karşılık gelen REST API komutları sekme olarak listelenir:

FarmManagementLogs

operationName
Microsoft.AgFoodPlatform/farmers/write
Microsoft.AgFoodPlatform/farmers/read
Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/farms/write
Microsoft.AgFoodPlatform/farms/read
Microsoft.AgFoodPlatform/farms/delete
Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/field/write
Microsoft.AgFoodPlatform/field/read
Microsoft.AgFoodPlatform/field/delete
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/seasonalField/write
Microsoft.AgFoodPlatform/seasonalField/read
Microsoft.AgFoodPlatform/seasonalField/delete
Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/boundaries/write
Microsoft.AgFoodPlatform/boundaries/read
Microsoft.AgFoodPlatform/boundaries/delete
Microsoft.AgFoodPlatform/boundaries/action
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/crops/write
Microsoft.AgFoodPlatform/crops/read
Microsoft.AgFoodPlatform/crops/delete
Microsoft.AgFoodPlatform/cropVarieties/write
Microsoft.AgFoodPlatform/cropVarieties/read
Microsoft.AgFoodPlatform/cropVarieties/delete
Microsoft.AgFoodPlatform/seasons/write
Microsoft.AgFoodPlatform/seasons/read
Microsoft.AgFoodPlatform/seasons/delete
Microsoft.AgFoodPlatform/ekler/yazma
Microsoft.AgFoodPlatform/ekler/okuma
Microsoft.AgFoodPlatform/attachments/delete
Microsoft.AgFoodPlatform/prescriptions/write
Microsoft.AgFoodPlatform/prescriptions/read
Microsoft.AgFoodPlatform/prescriptions/delete
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/prescriptionMaps/write
Microsoft.AgFoodPlatform/prescriptionMaps/read
Microsoft.AgFoodPlatform/prescriptionMaps/delete
Microsoft.AgFoodPlatform/deletionJobs/prescriptionMapsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/managementZones/write
Microsoft.AgFoodPlatform/managementZones/read
Microsoft.AgFoodPlatform/managementZones/delete
Microsoft.AgFoodPlatform/deletionJobs/managementZonescascadeDeletejobs/write
Microsoft.AgFoodPlatform/zones/write
Microsoft.AgFoodPlatform/zones/read
Microsoft.AgFoodPlatform/zones/delete
Microsoft.AgFoodPlatform/deletionJobs/zonesCascadedeleteJobs/write
Microsoft.AgFoodPlatform/plantTissueanalyses/write
Microsoft.AgFoodPlatform/plantTissueanalyses/read
Microsoft.AgFoodPlatform/plantTissueanalyses/delete
Microsoft.AgFoodPlatform/deletionJobs/plantTissueanalysesCascadedeleteJobs/write
Microsoft.AgFoodPlatform/nutrientAnalyses/write
Microsoft.AgFoodPlatform/nutrientAnalyses/read
Microsoft.AgFoodPlatform/nutrientAnalyses/delete
Microsoft.AgFoodPlatform//deletionJobs/nutrientAnalysescascadeDeletejobs/delete

FarmOperationLogs

operationName
Microsoft.AgFoodPlatform/ingetsionJobs/farmOperationsdataIngestionjobs/write
Microsoft.AgFoodPlatform/applicationData/read
Microsoft.AgFoodPlatform/applicationData/write
Microsoft.AgFoodPlatform/applicationData/delete
Microsoft.AgFoodPlatform/deletionJobs/applicationDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/plantingData/write
Microsoft.AgFoodPlatform/plantingData/read
Microsoft.AgFoodPlatform/plantingData/delete
Microsoft.AgFoodPlatform/deletionJobs/plantingDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/harvestingData/write
Microsoft.AgFoodPlatform/harvestingData/read
Microsoft.AgFoodPlatform/harvestingData/delete
Microsoft.AgFoodPlatform/deletionJobs/harvestingDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/tillageData/Write
Microsoft.AgFoodPlatform/tillageData/Read
Microsoft.AgFoodPlatform/tillageData/Delete
Microsoft.AgFoodPlatform/deletionJobs/tillageDatacascadeDeletejob/write

SatelliteLogs

operationName
Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataingestionJob/write
Microsoft.AgFoodPlatform/scenes/read

WeatherLogs

operationName
Microsoft.AgFoodPlatform/ingestionJobs/weatherDataingestionJob/write
Microsoft.AgFoodPlatform/weather/read
Microsoft.AgFoodPlatform/deletionJobs/weatherDeletejob/delete

ProviderAuthLogs

operationName
Microsoft.AgFoodPlatform/oauthProviders/write
Microsoft.AgFoodPlatform/oauthProviders/read
Microsoft.AgFoodPlatform/oauthProviders/delete
Microsoft.AgFoodPlatform/oauthTokens/read
Microsoft.AgFoodPlatform/oauthTokens/delete

JobProcessesLogs

operationName
Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataIngestionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/satelliteDataDeletionJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/weatherDataIngestionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/weatherDataDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/oauthProvidersCascadeDeleteJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/oauthTokensRemoveJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/biomassModelJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/ImageProcessingRasterizeJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationDataIngestionJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationDataIngestionJobs/processed/failures
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed/failures
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationEventHandlingJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationEventHandlingJobs/processed/failures
Microsoft.AgFoodPlatform/deletionJobs/applicationDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/tillageDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/plantingDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/harvestDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/managementZonesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/zonesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/plantTissueAnalysesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/prescriptionMapsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/insightsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeletionJobs/processed

ApplicationAuditLogs

Diğer kategorilerde bulunan yazma ve silme günlükleri de bu kategoride bulunur. Bu kategorideki günlüklerle aynı API çağrısının diğer kategorileri arasındaki fark, ApplicationAuditLogs'un istek gövdesini günlüğe kaydetmemesi, diğer kategorilerde ise istek gövdesinin doldurulmasıdır. Daha fazla ayrıntı almak için iki farklı kategorinin günlüklerini ilişkilendirmek için bağıntı-kimliği kullanın. Kategorilerin geri kalanında yer almayan bazı denetim düzlemi işlemleri aşağıda listelenmiştir.

Not

Denetim düzlemi çağrıları yapmak için ADMA kaynak kapsamında sahip erişimine ihtiyacınız vardır.

operationName
Tarım Kaynağı için Veri Yöneticisi Oluşturma
Tarım Kaynağı için Veri Yöneticisini Güncelleştirme
Tarım Kaynağı için Veri Yöneticisini Silme
Abonelik Oluşturma
Aboneliği Güncelleştir
Veri Düzlemi Kimlik Doğrulaması

Log Analytics çalışma alanında kaynak günlüklerini sorgulama

categories Tüm kaynak günlükleri Log Analytics'te bir tablo olarak eşlenir. Her kategorinin günlüklerine erişmek için log analytics çalışma alanına veri göndermek için bir tanılama ayarı oluşturmanız gerekir. Bu çalışma alanında, ilgili günlükleri almak için listelenen tablolardan herhangi birini sorgulayabilirsiniz.

Log Analytics'teki tabloların listesi ve bunların kaynak günlüklerindeki kategorilere eşlemesi

Log Analytics'te tablo adı	Kaynak günlüklerindeki kategoriler	Açıklama
AgriFoodFarmManagementLogs	FarmManagementLogs	Parti, Çiftlik, Alan, Mevsimsel Alan, Kırpma, CropVariety, Sezon, Ek, reçete haritaları, reçeteler, yönetim bölgeleri, bölgeler, bitki doku analizi ve besin analizleri için CRUD işlemleri için günlükler.
AgriFoodFarmOperationsLogs	FarmOperationsLogs	FarmOperations veri alımı işi, ApplicationData, PlantingData, HarvestingData, TillageData için CRUD işlemleri için günlükler.
AgriFoodSatelliteLogs	SatelliteLogs	Uydu veri alımı işi için oluşturma ve alma işlemleri için günlükler.
AgriFoodWeatherLogs	WeatherLogs	Hava durumu veri alımı işi için oluşturma, silme ve alma işlemlerinin günlükleri.
AgriFoodProviderAuthLogs	ProviderAuthLogs	Oauth sağlayıcıları için oluşturma, güncelleştirme, silme, art arda silme, alma ve alma günlükleri. Ayrıca, oauth belirteçleri için alma, tümünü alma, art arda silme günlükleri de vardır.
AgriFoodInsightLogs	InsightLogs	İçgörüler için tüm işlemleri alma ve alma günlükleri.
AgriFoodModelInferenceLogs	ModelInferenceLogs	Biyokütle modeli işi için oluşturma ve alma işlemleri için günlükler.
AgriFoodJobProcessedLogs	JobProcessedLogs	İşlerin başarılı veya başarısız olduğunu ve başarısız olma nedenini gösteren günlükler. Kaynak art arda silme işlerinin günlüklerine ek olarak, veri alımı işleri. Ayrıca grup işlemleri ve olay işleme işleri için günlükler içerir.
AgriFoodApplicationAuditLogs	ApplicationAuditLogs	Veri düzlemi kaynak oluşturma, güncelleştirme, silme ve abonelik yönetimi işlemleri gibi ayrıcalıklı eylemler için günlükler.

Log Analytics tablolarındaki sütunların listesi

Alan adı	Açıklama
Time	UTC olarak tarih ve saat.
ResourceId	Tarım günlükleri için Data Manager için Azure Resource Manager kaynak kimliği.
OperationName	Önceki tabloda belgelendiği gibi işlemin adı.
OperationVersion	İstemci tarafından istenen REST API sürümü.
Kategori	Tarım için Veri Yöneticisi günlüklerindeki kategori ayrıntıları, kategori tablosunda listelendiği gibi herhangi bir değer olabilir.
ResultType	REST API isteğinin sonucu (başarılı veya başarısız).
ResultSignature	HTTP durumu.
ResultDescription	Kullanılabilir olduğunda sonuç hakkında daha fazla açıklama.
SüreM'ler	Milisaniye cinsinden REST API'si isteğini sunmak için geçen süre.
CallerIpAddress	İsteği yapan istemcinin IP adresi.
Düzey	Olayın önem düzeyi (bilgilendirme, uyarı, hata veya kritik).
CorrelationId	Günlükleri ilişkilendirmek için kullanılabilecek isteğe bağlı bir GUID.
ApplicationId	Çağıranın kimliğini gösteren uygulama kimliği.
ObjectId	Çağıranın kimliğini gösteren nesne kimliği.
ClientTenantId	Çağıranın kiracısının kimliği.
SubscriptionId	Arayan tarafından kullanılan aboneliğin kimliği.
Konum	"Doğu ABD" gibi olayı yayan kaynağın bölgesi
JobRunType	Yalnızca AgriFoodJobProcessesLogs tabloda kullanılabilir, iş çalıştırmasının türünü gösterir. Değer dönemsel veya bir kerelik olabilir.
JobId	içindeAgriFoodJobProcessesLogs kullanılabilir, AgriFoodSatelliteLogs, AgriFoodWeatherLogsve AgriFoodModelInferenceLogs, işin kimliğini gösterir.
InitiatedBy	Yalnızca AgriFoodJobProcessesLogs tabloda kullanılabilir. bir işin bir kullanıcı tarafından mı yoksa hizmet tarafından mı başlatıldığını gösterir.
partyId	İşlemle ilişkili tarafın kimliği.
Veri Erişimi	YalnızcaAgriFoodJobProcessesLogs tabloda kullanılabilir: farmOperationEntityId (farmOperation işi tarafından oluşturulamayan varlığın kimliği), farmOperationEntityType(Oluşturulamayan varlığın türü ApplicationData, PeriodicJob, vb. olabilir), errorCode(Tarım için Veri Yöneticisi'nde işin başarısız olma kodu) (Tarım sonuerrorMessage için Veri Yöneticisi'nde hatanın açıklaması),(Sağlayıcı tarafından sağlanan işin başarısız olma kodu),internalErrorCode internalErrorMessage(Sağlayıcı tarafından sağlanan hatanın açıklaması),providerId(JOHN-DEERE gibi sağlayıcının kimliği).

Bu tabloların her biri bir log analytics çalışma alanı oluşturularak sorgulanabilir. Sorgu dili başvurusu buradadır.

Log Analytics çalışma alanında örnek sorguların listesi

Sorgu adı	Açıklama
Bir taraf için grup yönetimi işlemlerinin durumu	Her taraf için kategorideki FarmManagementLogs işlemlerin başarı ve başarısızlıklarının sayısını getirir.
Bir taraf için iş yürütme istatistikleri	Her taraf için kategorideki JobProcessedLogs tüm işlemlerin başarı ve başarısızlıklarının sayısını sağlar.
Başarısız Yetkilendirme	Kaynağınıza erişemeyen kullanıcıların listesini ve bu hatanın nedenini tanımlar.
Bir taraf için tüm işlemlerin durumu	Bir grup için kategoriler genelinde hataları ve başarıları toplar.
Gerçekleştirilen işlemlere göre ilk 100 taraf için kullanım eğilimleri	Kategoriler arasında alınan isabet sayısına göre ilk 100 tarafın listesini alır. Bu sorgu, belirli bir tarafın kullanım eğilimini izlemek için düzenlenebilir.

Yukarıda listelenen tüm sorgular, log analytics çalışma alanında özel sorgular oluşturmak için temel sorgular olarak kullanılabilir. Bu sorgu listesine, Azure portalındaki Logs Tarım için Azure Data Manager kaynağınızdaki sekmeden de erişilebilir.

Sonraki adımlar

Özel bağlantıları ayarlamayı öğrenin.