Memantau data Azure Cosmos DB menggunakan pengaturan diagnostik Analitik Log Azure Monitor

BERLAKU UNTUK: NoSQL MongoDB Cassandra Gremlin Meja

Pengaturan diagnostik di Azure digunakan untuk mengumpulkan log sumber daya. Sumber daya memancarkan Log sumber daya Azure dan menyediakan data yang kaya dan sering tentang pengoperasian sumber daya tersebut. Log ini diambil per permintaan dan disebut sebagai "log sarana data." Beberapa contoh operasi sarana data termasuk menghapus, menyisipkan, dan readFeed. Isi log ini bervariasi menurut jenis sumber daya.

Metrik platform dan Log aktivitas dikumpulkan secara otomatis, sedangkan Anda harus membuat pengaturan diagnostik untuk mengumpulkan log sumber daya atau meneruskannya di luar Azure Monitor. Anda dapat mengaktifkan pengaturan diagnostik untuk akun Azure Cosmos DB dan mengirim log sumber daya ke sumber berikut:

• Ruang kerja Analitik Log Azure Monitor
  • Data yang dikirim ke Analitik Log dapat ditulis ke tabel Diagnostik Azure (warisan) atau Khusus sumber daya (pratinjau)
• Pusat aktivitas
• Akun Penyimpanan

Catatan

Sebaiknya buat pengaturan diagnostik dalam mode khusus sumber daya (untuk semua API kecuali API untuk Tabel) mengikuti instruksi kami untuk membuat pengaturan diagnostik melalui REST API. Opsi ini menyediakan pengoptimalan biaya tambahan dengan tampilan yang ditingkatkan untuk menangani data.

Prasyarat

• Akun Azure Cosmos DB yang sudah ada.
  • Jika Anda memiliki langganan Azure, buat akun baru.
  • Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
  • Atau, Anda dapat mencoba Azure Cosmos DB gratis sebelum berkomitmen.
• Ruang kerja Analitik Log Azure Monitor yang sudah ada.

Membuat pengaturan diagnostik

Di sini, kami menelusuri proses pembuatan pengaturan diagnostik untuk akun Anda.

Catatan

Metrik untuk mengekspor log sebagai kategori saat ini tidak didukung.

Portal Azure

1. Masuk ke portal Azure.

2. Navigasikan ke akun Azure Cosmos DB Anda yang sudah ada.

3. Di bagian Pemantauan dari menu sumber daya, pilih Pengaturan diagnostik. Kemudian, pilih opsi Tambahkan pengaturan diagnostik.

   

   Penting

   Anda mungkin melihat perintah untuk "mengaktifkan kueri teks lengkap [...] untuk pengelogan yang lebih rinci" jika fitur kueri teks lengkap tidak diaktifkan di akun Anda. Anda dapat mengabaikan peringatan ini dengan aman jika Anda tidak ingin mengaktifkan fitur ini. Untuk informasi selengkapnya, lihat mengaktifkan kueri teks lengkap.

4. Di panel Pengaturan diagnostik, beri nama pengaturan contoh pengaturan lalu pilih kategori QueryRuntimeStatistics. Kirim log ke Ruang Kerja Analitik Log yang memilih ruang kerja yang sudah ada. Terakhir, pilih Sumber Daya khusus sebagai opsi tujuan.

   

Azure CLI

az monitor diagnostic-settings create Gunakan perintah untuk membuat pengaturan diagnostik dengan Azure CLI. Lihat dokumentasi untuk perintah ini untuk deskripsi parameternya.

1. Pastikan Anda masuk ke Azure CLI. Untuk informasi selengkapnya, lihat masuk dengan Azure CLI.

2. Gunakan az monitor diagnostic-settings create untuk membuat pengaturan.

   az monitor diagnostic-settings create \
     --resource $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --workspace $(az monitor log-analytics workspace show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --name "example-setting" \
     --export-to-resource-specific true \
     --logs '[
       {
         "category": "QueryRuntimeStatistics",
         "enabled": true
       }
     ]'
   

   Penting

   Sampel ini menggunakan --export-to-resource-specific argumen untuk mengaktifkan tabel khusus sumber daya.

3. Tinjau hasil pembuatan pengaturan baru Anda menggunakan az monitor diagnostics-settings show.

   az monitor diagnostic-settings show \
     --name "example-setting" \
     --resource $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     )
   

REST API

Gunakan Azure Monitor REST API untuk membuat pengaturan diagnostik melalui konsol interaktif.

1. Pastikan Anda masuk ke Azure CLI. Untuk informasi selengkapnya, lihat masuk dengan Azure CLI.

2. Buat pengaturan diagnostik untuk sumber daya Azure Cosmos DB Anda menggunakan permintaan HTTP PUT dan az rest.

   diagnosticSettingName="example-setting"
   
   resourceId=$(az cosmosdb show \
     --resource-group "<resource-group-name>" \
     --name "<account-name>" \
     --query "id" \
     --output "tsv" \
   )
   
   workspaceId=$(az monitor log-analytics workspace show \
     --resource-group "<resource-group-name>" \
     --name "<account-name>" \
     --query "id" \
     --output "tsv" \
   )
   
   az rest \
     --method "PUT" \
     --url "$resourceId/providers/Microsoft.Insights/diagnosticSettings/$diagnosticSettingName" \
     --url-parameters "api-version=2021-05-01-preview" \
     --body '{
       "properties": {
         "workspaceId": "'"$workspaceId"'",
         "logs": [
           {
             "category": "QueryRuntimeStatistics",
             "enabled": true
           }
         ],
         "logAnalyticsDestinationType": "Dedicated"
       }
     }'
   

   Penting

   Sampel ini mengatur logAnalyticsDestinationType properti untuk Dedicated mengaktifkan tabel khusus sumber daya.

3. Gunakan az rest lagi dengan kata kerja HTTP GET untuk mendapatkan properti pengaturan diagnostik.

   diagnosticSettingName="example-setting"
   
   resourceId=$(az cosmosdb show \
     --resource-group "<resource-group-name>" \
     --name "<account-name>" \
     --query "id" \
     --output "tsv" \
   )
   
   az rest \
     --method "GET" \
     --url "$resourceId/providers/Microsoft.Insights/diagnosticSettings/$diagnosticSettingName" \
     --url-parameters "api-version=2021-05-01-preview"
   

Bicep

Gunakan templat Bicep untuk membuat pengaturan diagnostik.

1. Pastikan Anda masuk ke Azure CLI. Untuk informasi selengkapnya, lihat masuk dengan Azure CLI.

2. Buat file baru bernama diagnosticSetting.bicep.

3. Masukkan konten templat Bicep berikut yang menyebarkan pengaturan diagnostik untuk sumber daya Azure Cosmos DB Anda.

   @description('The name of the diagnostic setting to create.')
   param diagnosticSettingName string = 'example-setting'
   
   @description('The name of the Azure Cosmos DB account to monitor.')
   param azureCosmosDbAccountName string
   
   @description('The name of the Azure Monitor Log Analytics workspace to use.')
   param logAnalyticsWorkspaceName string
   
   resource azureCosmosDbAccount 'Microsoft.DocumentDB/databaseAccounts@2021-06-15' existing = {
     name: azureCosmosDbAccountName
   }
   
   resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2023-09-01' existing = {
     name: logAnalyticsWorkspaceName
   }
   
   resource diagnosticSetting 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
     name: diagnosticSettingName
     scope: azureCosmosDbAccount
     properties: {
       workspaceId: logAnalyticsWorkspace.id
       logAnalyticsDestinationType: 'Dedicated'
       logs: [
         {
           category: 'QueryRuntimeStatistics'
           enabled: true
         }
       ]
     }
   }    
   

   Penting

   Sampel ini mengatur logAnalyticsDestinationType properti untuk Dedicated mengaktifkan tabel khusus sumber daya.

4. Sebarkan templat menggunakan az deployment group create.

   az deployment group create \
       --resource-group "<resource-group-name>" \
       --template-file diagnosticSetting.bicep \
       --parameters \
         azureCosmosDbAccountName="<azure-cosmos-db-account-name>" \
         logAnalyticsWorkspaceName="<log-analytics-workspace-name>"
   

   Tip

   az bicep build Gunakan perintah untuk mengonversi templat Bicep menjadi templat Azure Resource Manager.

Templat ARM

Gunakan templat Azure Resource Manager untuk membuat pengaturan diagnostik.

1. Pastikan Anda masuk ke Azure CLI. Untuk informasi selengkapnya, lihat masuk dengan Azure CLI.

2. Buat file baru bernama diagnosticSetting.bicep.

3. Masukkan konten templat Azure Resource Manager berikut yang menyebarkan pengaturan diagnostik untuk sumber daya Azure Cosmos DB Anda.

   {
     "$schema": "<https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#>",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "diagnosticSettingName": {
         "type": "string",
         "defaultValue": "example-setting",
         "metadata": {
           "description": "The name of the diagnostic setting to create."
         }
       },
       "azureCosmosDbAccountName": {
         "type": "string",
         "metadata": {
           "description": "The name of the Azure Cosmos DB account to monitor."
         }
       },
       "logAnalyticsWorkspaceName": {
         "type": "string",
         "metadata": {
           "description": "The name of the Azure Monitor Log Analytics workspace to use."
         }
       }
     },
     "resources": [
       {
         "type": "Microsoft.Insights/diagnosticSettings",
         "apiVersion": "2021-05-01-preview",
         "scope": "[format('Microsoft.DocumentDB/databaseAccounts/{0}', parameters('azureCosmosDbAccountName'))]",
         "name": "[parameters('diagnosticSettingName')]",
         "properties": {
           "workspaceId": "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('logAnalyticsWorkspaceName'))]",
           "logAnalyticsDestinationType": "Dedicated",
           "logs": [
             {
               "category": "QueryRuntimeStatistics",
               "enabled": true
             }
           ]
         }
       }
     ]
   }
   

   Penting

   Sampel ini mengatur logAnalyticsDestinationType properti untuk Dedicated mengaktifkan tabel khusus sumber daya.

4. Sebarkan templat menggunakan az deployment group create.

   az deployment group create \
       --resource-group "<resource-group-name>" \
       --template-file azuredeploy.json \
       --parameters \
         azureCosmosDbAccountName="<azure-cosmos-db-account-name>" \
         logAnalyticsWorkspaceName="<log-analytics-workspace-name>"
   

   Tip

   az bicep decompile Gunakan perintah untuk mengonversi templat Azure Resource Manager menjadi templat Bicep.

Mengaktifkan kueri teks lengkap untuk mencatat teks kueri

Azure Cosmos DB menyediakan logging lanjutan untuk pemecahan masalah terperinci. Dengan mengaktifkan kueri teks lengkap, Anda dapat menampilkan kueri deobfuscated untuk semua permintaan dalam akun Azure Cosmos DB Anda. Anda juga memberikan izin bagi Azure Cosmos DB untuk mengakses dan menampilkan data ini di log Anda.

Peringatan

Mengaktifkan fitur ini dapat menimbulkan biaya pengelogan tambahan, untuk rincian harga kunjungi harga Azure Monitor. Disarankan untuk menonaktifkan fitur ini setelah pemecahan masalah.

Portal Azure

1. Pada halaman akun Azure Cosmos DB yang sudah ada, pilih opsi Fitur di dalam bagian Pengaturan menu sumber daya. Kemudian, pilih fitur kueri teks lengkap Diagnostik.

   

2. Dalam dialog, pilih Enable. Pengaturan ini diterapkan dalam beberapa menit. Semua log yang baru diserap sekarang memiliki teks lengkap atau teks PIICommand untuk setiap permintaan.

   

Azure CLI / REST API / Bicep / Templat ARM

Gunakan Azure CLI untuk mengaktifkan kueri teks lengkap untuk akun Azure Cosmos DB Anda.

1. Aktifkan kueri teks lengkap menggunakan az rest lagi dengan kata kerja HTTP PATCH dan payload JSON.

   az rest \
     --method "PATCH" \
     --url $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --url-parameters "api-version=2021-05-01-preview" \
     --body '{
       "properties": {
         "diagnosticLogSettings": {
           "enableFullTextQuery": "True"
         }
       }
     }'
   

2. Tunggu beberapa menit hingga operasi selesai. Periksa status kueri teks lengkap dengan menggunakan az rest lagi dengan HTTP GET.

   az rest \
     --method "GET" \
     --url $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --url-parameters "api-version=2021-05-01-preview" \
     --query "{accountName:name,fullTextQueryEnabled:properties.diagnosticLogSettings.enableFullTextQuery}"
   

   Output harus mirip dengan contoh ini.

   {
     "accountName": "<account-name>",
     "fullTextQueryEnabled": "True"
   }
   

Konten terkait

• Kueri diagnostik di API untuk NoSQL
• Kueri diagnostik di API untuk MongoDB
• Kueri diagnostik di API untuk Apache Cassandra