Bagikan melalui


Bermigrasi ke sumber daya Application Insights berbasis ruang kerja

Artikel ini memandu Anda memigrasikan sumber daya Application Insights klasik ke sumber daya berbasis ruang kerja.

Sumber daya berbasis ruang kerja:

Kapabilitas baru

Sumber daya Application Insights berbasis ruang kerja memungkinkan Anda memanfaatkan kemampuan terbaru Azure Monitor dan Analitik Log:

  • Kunci yang dikelola pelanggan menyediakan enkripsi saat tidak aktif untuk data Anda dengan kunci enkripsi yang hanya dapat Anda akses.
  • Azure Private Link memungkinkan Anda menautkan platform Azure sebagai layanan (PaaS) dengan aman ke jaringan virtual Anda dengan menggunakan titik akhir privat.
  • Profiler dan Snapshot Debugger Bring your own storage (BYOS) memberi Anda kontrol penuh atas:
    • Kebijakan enkripsi saat tidak aktif.
    • Kebijakan manajemen seumur hidup.
    • Akses jaringan untuk semua data yang terkait dengan Application Insights Profiler dan Snapshot Debugger.
  • Tingkat komitmen memungkinkan Anda menghemat hingga 30% dibandingkan dengan harga bayar sesuai pemakaian. Jika tidak, penagihan untuk penyerapan data prabayar dan retensi data di Analitik Log mirip dengan penagihan di Application Insights.
  • Data diserap lebih cepat melalui penyerapan streaming Analitik Log.

Catatan

Setelah Anda bermigrasi ke sumber daya Application Insights berbasis ruang kerja, telemetri dari beberapa sumber daya Application Insights mungkin disimpan di ruang kerja Analitik Log umum. Anda masih dapat menarik data dari sumber daya Application Insights tertentu, seperti yang dijelaskan di bagian Memahami kueri log.

Proses migrasi

Saat Anda bermigrasi ke sumber daya berbasis ruang kerja, tidak ada data yang ditransfer dari penyimpanan sumber daya klasik ke penyimpanan berbasis ruang kerja baru. Memilih untuk bermigrasi akan mengubah lokasi tempat data baru ditulis ke ruang kerja Log Analytics sambil mempertahankan akses ke data sumber daya klasik Anda.

Data sumber daya klasik Anda bertahan dan tunduk pada pengaturan retensi pada sumber daya Application Insights klasik Anda. Semua data baru yang diserap pasca migrasi tunduk pada pengaturan retensi ruang kerja Analitik Log terkait, yang juga mendukung pengaturan retensi yang berbeda berdasarkan jenis data.

Proses migrasi bersifat permanen dan tidak dapat dibatalkan. Setelah Anda memigrasikan sumber daya ke Application Insights berbasis ruang kerja, sumber daya tersebut akan selalu menjadi sumber daya berbasis ruang kerja. Setelah bermigrasi, Anda dapat mengubah ruang kerja target sesering yang diperlukan.

Jika Anda tidak perlu memigrasikan sumber daya yang ada, dan sebaliknya ingin membuat sumber daya Application Insights berbasis ruang kerja baru, lihat panduan pembuatan sumber daya berbasis Ruang Kerja.

Catatan

Proses migrasi tidak boleh memperkenalkan waktu henti aplikasi atau memulai ulang atau mengubah kunci instrumentasi atau string koneksi yang ada.

Prasyarat

  • Ruang kerja Analitik Log dengan mode kontrol akses diatur ke pengaturan "Gunakan izin sumber daya atau ruang kerja" :

    • Sumber daya Application Insights berbasis ruang kerja tidak kompatibel dengan ruang kerja yang diatur ke pengaturan izin berbasis ruang kerja khusus. Untuk mempelajari selengkapnya tentang kontrol akses ruang kerja Analitik Log, lihat panduan Mode kontrol akses.
    • Jika Anda belum memiliki ruang kerja Analitik Log yang sudah ada, lihat dokumentasi pembuatan ruang kerja Analitik Log.
  • Ekspor berkelanjutan tidak kompatibel dengan sumber daya berbasis ruang kerja dan harus dinonaktifkan. Setelah migrasi selesai, Anda dapat menggunakan pengaturan diagnostik untuk mengonfigurasi pengarsipan data ke akun penyimpanan atau streaming ke Azure Event Hubs.

    Perhatian

    • Pengaturan diagnostik menggunakan format/ skema yang berbeda dengan ekspor berkelanjutan. Migrasi memutus integrasi yang sudah ada dengan Azure Stream Analytics.
    • Mengekspor pengaturan diagnostik dapat meningkatkan biaya. Untuk informasi selengkapnya, lihat Mengekspor telemetri dari Application Insights.
  • Periksa pengaturan retensi Anda saat ini di bawah Penggunaan Pengaturan>dan perkiraan biaya>Retensi Data untuk ruang kerja Analitik Log Anda. Pengaturan ini memengaruhi berapa lama data baru yang diserap disimpan setelah Anda memigrasikan sumber daya Application Insights Anda.

    Catatan

    • Jika saat ini Anda menyimpan data Application Insights lebih lama dari default 90 hari dan ingin mempertahankan periode retensi yang lebih lama ini setelah migrasi, sesuaikan pengaturan retensi ruang kerja Anda.
    • Jika Anda telah memilih retensi data lebih dari 90 hari pada data yang diserap ke dalam sumber daya Application Insights klasik sebelum migrasi, retensi data terus ditagih melalui sumber daya Application Insights tersebut hingga data melebihi periode retensi.
    • Jika pengaturan retensi untuk instans Application Insights Anda di bawah Konfigurasi>Penggunaan dan perkiraan biaya>Retensi Data diaktifkan, gunakan pengaturan tersebut untuk mengontrol hari retensi untuk data telemetri yang masih disimpan di penyimpanan sumber daya klasik Anda.
  • Memahami penggunaan dan biaya Application Insights berbasis ruang kerja.

Menemukan sumber daya Application Insights Klasik Anda

Anda dapat menggunakan metode berikut untuk menemukan sumber daya Application Insights Klasik dalam langganan Anda:

Sumber daya Application Insights di portal Azure

Dalam Gambaran Umum sumber daya Application Insights, sumber daya Application Insights Klasik tidak memiliki Ruang Kerja yang ditautkan dan banner peringatan penghentian Application Insights Klasik muncul. Sumber daya berbasis ruang kerja memiliki ruang kerja tertaut dalam bagian gambaran umum

Sumber daya klasik: Cuplikan layar halaman ringkasan portal Application Insights klasik.

Sumber daya berbasis ruang kerja: Cuplikan layar halaman ringkasan portal Application Insights berbasis ruang kerja.

Azure Resource Graph

Anda dapat menggunakan Penjelajah Azure Resource Graph (ARG) dan menjalankan kueri pada tabel 'sumber daya' untuk menarik informasi ini:

resources
| where subscriptionId == 'Replace with your own subscription ID'
| where type contains 'microsoft.insights/components'
| distinct resourceGroup, name, tostring(properties['IngestionMode']), tostring(properties['WorkspaceResourceId'])

Catatan

Sumber daya klasik diidentifikasi oleh nilai 'ApplicationInsights', 'N/A', atau Kosong .

Azure CLI:

Jalankan skrip berikut dari Cloud Shell di portal tempat autentikasi dibangun atau di tempat lain setelah mengautentikasi menggunakan az login:

$resources = az resource list --resource-type 'microsoft.insights/components' | ConvertFrom-Json

$resources | Sort-Object -Property Name | Format-Table -Property @{Label="App Insights Resource"; Expression={$_.name}; width = 35}, @{Label="Ingestion Mode"; Expression={$mode = az resource show --name $_.name --resource-group $_.resourceGroup --resource-type microsoft.insights/components --query "properties.IngestionMode" -o tsv; $mode}; width = 45}

Catatan

Sumber daya klasik diidentifikasi oleh nilai 'ApplicationInsights', 'N/A', atau Kosong . Skrip PowerShell berikut ini dapat dijalankan dari Azure CLI:

$subscription = "SUBSCRIPTION ID GOES HERE"
$token = (Get-AZAccessToken).Token
$header = @{Authorization = "Bearer $token"}
$uri = "https://management.azure.com/subscriptions/$subscription/providers/Microsoft.Insights/components?api-version=2015-05-01"
$RestResult=""
$RestResult = Invoke-RestMethod -Method GET -Uri $uri -Headers $header -ContentType "application/json" -ErrorAction Stop -Verbose
 $list=@()
$ClassicList=@()
foreach ($app in $RestResult.value)
  {
    #"processing: " + $app.properties.WorkspaceResourceId  ##  Classic Application Insights do not have a workspace.
    if ($app.properties.WorkspaceResourceId)
      {
        $Obj = New-Object -TypeName PSObject
        #$app.properties.WorkspaceResourceId
        $Obj | Add-Member -Type NoteProperty -Name Name  -Value $app.name
        $Obj | Add-Member -Type NoteProperty -Name WorkspaceResourceId  -Value $app.properties.WorkspaceResourceId
        $list += $Obj
      }
     else
      {
        $Obj = New-Object -TypeName PSObject
        $app.properties.WorkspaceResourceId
        $Obj | Add-Member -Type NoteProperty -Name Name  -Value $app.name
        $ClassicList += $Obj
       }
  }
$list |Format-Table -Property Name, WorkspaceResourceId -Wrap
  "";"Classic:"
$ClassicList | FT

Melakukan migrasi sumber daya Anda

Untuk memigrasikan sumber daya Application Insights klasik ke sumber daya berbasis ruang kerja:

  1. Dari sumber daya Application Insights Anda, pilih "Properti" di bawah judul "Konfigurasikan" di menu di sebelah kiri.

    Cuplikan layar yang memperlihatkan Properti di bawah judul Yang dikonfigurasi.

  2. Pilih Migrasi ke berbasis Ruang Kerja.

    Cuplikan layar yang memperlihatkan tombol Migrasi ke berbasis Ruang Kerja.

  3. Pilih ruang kerja Analitik Log tempat Anda ingin semua telemetri Application Insights yang diserap di masa mendatang disimpan. Ini bisa menjadi ruang kerja Analitik Log dalam langganan yang sama atau langganan lain yang berbagi penyewa Microsoft Entra yang sama. Ruang kerja Log Analytics tidak harus berada dalam grup sumber daya yang sama dengan sumber daya Application Insights.

    Catatan

    Migrasi ke sumber daya berbasis ruang kerja dapat memakan waktu hingga 24 jam, tetapi prosesnya biasanya lebih cepat. Mengandalkan akses data melalui sumber daya Application Insights saat Anda menunggu proses migrasi selesai. Setelah selesai, Anda akan melihat data baru yang disimpan di tabel ruang kerja Analitik Log.

    Cuplikan layar yang memperlihatkan UI Wizard migrasi dengan opsi untuk memilih ruang kerja target.

    Setelah sumber daya Anda dimigrasikan, Anda akan melihat informasi ruang kerja terkait di panel Gambaran Umum .

    Cuplikan layar yang memperlihatkan nama Ruang Kerja.

    Memilih teks tautan biru akan membawa Anda ke ruang kerja Analitik Log terkait tempat Anda dapat memanfaatkan lingkungan kueri ruang kerja terpadu baru.

Tip

Setelah Anda bermigrasi ke sumber daya Application Insights berbasis ruang kerja, gunakan batas harian ruang kerja untuk membatasi penyerapan dan biaya alih-alih batas di Application Insights.

Memahami kueri log

Kami menyediakan kompatibilitas mundur penuh untuk kueri sumber daya klasik Application Insights, buku kerja, dan pemberitahuan berbasis log dalam pengalaman Application Insights Anda.

Untuk menulis kueri terhadap struktur/skema tabel berbasis ruang kerja baru, Anda harus terlebih dahulu membuka ruang kerja Log Analytics Anda.

Untuk memastikan kueri berhasil dijalankan, validasi bahwa bidang kueri selaras dengan bidang skema baru.

Anda mungkin memiliki beberapa sumber daya Application Insights yang menyimpan telemetri di satu ruang kerja Analitik Log, tetapi Anda ingin mengkueri data dari satu sumber daya Application Insights tertentu. Anda memiliki dua pilihan:

  • Buka sumber daya Application Insights Anda dan pilih tab Log . Semua kueri dari tab ini secara otomatis menarik data dari sumber daya Application Insights yang dipilih.
  • Buka ruang kerja Analitik Log yang Anda konfigurasi sebagai tujuan telemetri Application Insights Anda dan pilih tab Log . Untuk mengkueri data dari sumber daya Application Insights tertentu, filter untuk properti bawaan _ResourceId yang tersedia di semua tabel khusus aplikasi.

Saat Anda mengkueri langsung dari ruang kerja Analitik Log, Anda hanya melihat data yang diserap pasca migrasi. Untuk melihat data Application Insights klasik dan data baru yang diserap setelah migrasi dalam pengalaman kueri terpadu, gunakan tab Log dari dalam sumber daya Application Insights Anda yang dimigrasikan.

Catatan

Jika Anda mengganti nama sumber daya Application Insights setelah bermigrasi ke model berbasis ruang kerja, tab Log Application Insights tidak lagi menampilkan telemetri yang dikumpulkan sebelum mengganti nama. Anda dapat melihat semua data lama dan baru di tab Log dari sumber daya Analitik Log terkait.

Mengidentifikasi sumber daya Application Insights berdasarkan jenis penyerapan

Gunakan skrip berikut untuk mengidentifikasi sumber daya Application Insights Anda berdasarkan jenis penyerapan.

Contoh

Get-AzApplicationInsights -SubscriptionId 'Your Subscription ID' | Format-Table -Property Name, IngestionMode, Id, @{label='Type';expression={
    if ([string]::IsNullOrEmpty($_.IngestionMode)) {
        'Unknown'
    } elseif ($_.IngestionMode -eq 'LogAnalytics') {
        'Workspace-based'
    } elseif ($_.IngestionMode -eq 'ApplicationInsights' -or $_.IngestionMode -eq 'ApplicationInsightsWithDiagnosticSettings') {
        'Classic'
    } else {
        'Unknown'
    }
}}

Migrasi sumber daya terprogram

Bagian ini membantu Anda memigrasikan sumber daya Anda.

Azure CLI

Untuk mengakses perintah pratinjau Application Insights Azure CLI, Anda harus menjalankan terlebih dahulu:

 az extension add -n application-insights

Jika Anda tidak menjalankan az extension add perintah, Anda akan melihat pesan kesalahan yang menyatakan az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Sekarang Anda dapat menjalankan kode berikut untuk membuat sumber daya Application Insights Anda:

az monitor app-insights component update --app
                                         --resource-group
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--query-access {Disabled, Enabled}]
                                         [--retention-time]
                                         [--workspace]

Contoh

az monitor app-insights component update --app your-app-insights-resource-name -g your_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

Untuk dokumentasi Azure CLI lengkap untuk perintah ini, lihat dokumentasi Azure CLI.

Azure PowerShell

Dimulai dengan Azure PowerShell versi 8.0 atau yang lebih tinggi, Anda dapat menggunakan Update-AzApplicationInsights perintah PowerShell untuk memigrasikan sumber daya Application Insights klasik ke ruang kerja berbasis.

Untuk menggunakan cmdlet ini, Anda perlu menentukan nama dan grup sumber daya sumber daya Application Insights yang ingin Anda perbarui. IngestionMode Gunakan parameter dan WorkspaceResoruceId untuk memigrasikan instans klasik Anda ke berbasis ruang kerja. Untuk informasi selengkapnya tentang parameter dan sintaks cmdlet ini, lihat Update-AzApplicationInsights.

Contoh

# Get the resource ID of the Log Analytics workspace
$workspaceResourceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName "rgName" -Name "laName").ResourceId

# Update the Application Insights resource with the workspace parameter
Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -IngestionMode LogAnalytics -WorkspaceResourceId $workspaceResourceId

Templat Azure Resource Manager

Bagian ini menyediakan templat.

Perhatian

Pastikan Anda telah menghapus semua pengaturan Ekspor Berkelanjutan dari sumber daya Anda sebelum menjalankan templat migrasi. Lihat Prasyarat

File templat

{
    "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "string"
        },
        "type": {
            "type": "string"
        },
        "regionId": {
            "type": "string"
        },
        "tagsArray": {
            "type": "object"
        },
        "requestSource": {
            "type": "string"
        },
        "workspaceResourceId": {
            "type": "string"
        }
    },
    "resources": [
        {
            "name": "[parameters('name')]",
            "type": "microsoft.insights/components",
            "location": "[parameters('regionId')]",
            "tags": "[parameters('tagsArray')]",
            "apiVersion": "2020-02-02-preview",
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Application_Type": "[parameters('type')]",
                "Flow_Type": "Redfield",
                "Request_Source": "[parameters('requestSource')]",
                "WorkspaceResourceId": "[parameters('workspaceResourceId')]"
            }
        }
    ]
}

File parameter

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "type": {
            "value": "web"
        },
        "name": {
            "value": "customresourcename"
        },
        "regionId": {
            "value": "eastus"
        },
        "tagsArray": {
            "value": {}
        },
        "requestSource": {
            "value": "Custom"
        },
        "workspaceResourceId": {
            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
        }
    }
}

Memodifikasi ruang kerja terkait

Setelah membuat sumber daya Application Insights berbasis ruang kerja, Anda dapat memodifikasi ruang kerja Analitik Log terkait.

Dari dalam panel sumber daya Application Insights, pilih Properti>Ubah Ruang Kerja>Log Analytics Workspaces.

Tanya jawab umum

Bagian ini menyediakan jawaban atas pertanyaan umum.

Apa yang terjadi jika saya tidak memigrasikan sumber daya klasik Application Insights saya ke sumber daya berbasis ruang kerja?

Microsoft memulai pendekatan bertahas untuk memigrasikan sumber daya klasik ke sumber daya berbasis ruang kerja pada Mei 2024 dan migrasi ini sedang berlangsung selama beberapa bulan. Kami tidak dapat memberikan perkiraan tanggal migrasi sumber daya, langganan, atau wilayah tertentu.

Kami sangat mendorong migrasi manual ke sumber daya berbasis ruang kerja. Proses ini dimulai dengan memilih banner pemberitahuan penghentian. Anda dapat menemukannya di panel Gambaran Umum sumber daya Application Insights klasik dari portal Azure. Proses ini biasanya melibatkan satu langkah memilih ruang kerja Analitik Log mana yang digunakan untuk menyimpan data aplikasi Anda. Jika Anda menggunakan ekspor berkelanjutan, Anda perlu juga bermigrasi ke pengaturan diagnostik atau menonaktifkan fitur terlebih dahulu.

Jika Anda tidak ingin sumber daya klasik Anda dimigrasikan secara otomatis ke sumber daya berbasis ruang kerja, Anda dapat menghapus atau memigrasikan sumber daya secara manual.

Apakah ada implikasi pada biaya dari migrasi?

Biasanya tidak ada perbedaan, dengan dua pengecualian.

  • Sumber daya Application Insights yang menerima 1 GB per bulan gratis melalui model harga Application Insights warisan tidak menerima data gratis.
  • Sumber daya Application Insights yang berada di tingkat harga dasar sebelum April 2018 terus ditagih pada titik harga nonregional yang sama seperti sebelum April 2018. Sumber daya Application Insights yang dibuat setelah waktu itu, atau sumber daya yang dikonversi menjadi berbasis ruang kerja, akan menerima harga regional saat ini. Untuk harga saat ini di mata uang dan wilayah Anda, lihat Harga Application Insights.

Migrasi ke Application Insights berbasis ruang kerja menawarkan banyak opsi untuk mengoptimalkan biaya lebih lanjut, termasuk tingkat komitmen Analitik Log, kluster khusus, dan log Dasar dan Tambahan.

Bagaimana cara kerja pembatasan telemetri?

Anda dapat mengatur batas harian di ruang kerja Log Analytics.

Tidak tersedia pembatasan penagihan yang ketat.

Bagaimana cara kerja pengambilan sampel berbasis penyerapan?

Tidak ada perubahan pada pengambilan sampel berbasis penyerapan.

Apakah ada celah dalam data yang dikumpulkan selama migrasi?

Tidak. Kami menggabungkan data selama kueri.

Apakah kueri log lama terus berfungsi?

Ya, mereka terus bekerja.

Apakah dasbor saya dengan metrik dan bagan log yang disematkan akan terus berfungsi setelah migrasi?

Ya, mereka terus bekerja.

Apakah migrasi memengaruhi API AppInsights yang mengakses data?

Tidak. Migrasi tidak memengaruhi akses API yang ada ke data. Setelah migrasi, Anda dapat mengakses data langsung dari ruang kerja dengan menggunakan skema yang sedikit berbeda.

Apakah ada dampak pada Metrik Langsung atau pengalaman pemantauan lainnya?

Tidak. Tidak ada dampak terhadap Metrik Langsung atau pengalaman pemantauan lainnya.

Apa yang terjadi dengan ekspor berkelanjutan setelah migrasi?

Untuk melanjutkan ekspor otomatis, Anda perlu bermigrasi ke pengaturan diagnostik sebelum bermigrasi ke sumber daya berbasis ruang kerja. Pengaturan diagnostik dilakukan dalam migrasi ke Application Insights berbasis ruang kerja.

Bagaimana cara memastikan keberhasilan migrasi sumber daya App Insights saya menggunakan Terraform?

Jika Anda menggunakan Terraform untuk mengelola sumber daya Azure, penting untuk menggunakan versi terbaru penyedia Azurerm Terraform sebelum mencoba meningkatkan sumber daya App Insights Anda. Penggunaan versi penyedia yang lebih lama, seperti versi 3.12, dapat mengakibatkan penghapusan komponen klasik sebelum membuat sumber daya Application Insights berbasis ruang kerja pengganti. Ini dapat menyebabkan hilangnya data sebelumnya dan memerlukan pembaruan konfigurasi di aplikasi yang dipantau dengan nilai kunci string koneksi dan instrumentasi baru.

Untuk menghindari masalah ini, pastikan untuk menggunakan versi terbaru penyedia Azurerm Terraform, versi 3.89 atau yang lebih tinggi. Ini melakukan langkah-langkah migrasi yang tepat dengan mengeluarkan panggilan Azure Resource Manager (ARM) yang sesuai untuk meningkatkan sumber daya klasik App Insights ke sumber daya berbasis ruang kerja sambil mempertahankan semua data lama dan nilai kunci string koneksi/instrumentasi.

Apakah saya masih dapat menggunakan API lama untuk membuat sumber daya Application Insights secara terprogram?

Untuk kompatibilitas mundur, panggilan ke API lama untuk membuat sumber daya Application Insights terus berfungsi. Masing-masing panggilan ini membuat sumber daya Application Insights berbasis ruang kerja dan ruang kerja Analitik Log untuk menyimpan data.

Kami sangat mendorong pembaruan ke API baru untuk kontrol yang lebih baik atas pembuatan sumber daya.

Haruskah saya memigrasikan pengaturan diagnostik pada Application Insights klasik sebelum pindah ke AI berbasis ruang kerja?

Ya, sebaiknya migrasikan pengaturan diagnostik pada sumber daya Application Insights klasik sebelum beralih ke Application Insights berbasis ruang kerja. Ini memastikan kelangsungan dan kompatibilitas pengaturan diagnostik Anda.

Pemecahan Masalah

Bagian ini menyediakan tips pemecahan masalah.

Mode akses

Pesan kesalahan: "Ruang kerja yang dipilih dikonfigurasi dengan mode akses berbasis ruang kerja. Beberapa fitur Pemantauan Performa Aplikasi (APM) dapat terpengaruh. Pilih ruang kerja lain atau izinkan akses berbasis sumber daya di pengaturan ruang kerja. Anda dapat mengambil alih kesalahan ini dengan menggunakan CLI."

Agar sumber daya Application Insights berbasis ruang kerja beroperasi dengan benar, Anda perlu mengubah mode kontrol akses ruang kerja Analitik Log target Anda ke pengaturan Izin sumber daya atau ruang kerja. Pengaturan ini terletak di antarmuka pengguna ruang kerja Log Analytics pada Properti>Mode kontrol akses. Untuk petunjuknya, lihat panduan mode kontrol akses konfigurasi Log Analytics. Jika mode kontrol akses Anda diatur ke pengaturan eksklusif Memerlukan izin ruang kerja, migrasi melalui pengalaman migrasi portal tetap diblokir.

Jika Anda tidak dapat mengubah mode kontrol akses karena alasan keamanan untuk ruang kerja target Anda saat ini, buat ruang kerja Analitik Log baru untuk digunakan untuk migrasi.

Ekspor berkelanjutan

Pesan kesalahan: "Ekspor Berkelanjutan perlu dinonaktifkan sebelum melanjutkan. Setelah migrasi, gunakan Pengaturan Diagnostik untuk ekspor."

Fungsionalitas ekspor berkelanjutan warisan tidak didukung untuk sumber daya berbasis ruang kerja. Sebelum bermigrasi, Anda perlu mengaktifkan pengaturan diagnostik dan menonaktifkan ekspor berkelanjutan.

  1. Aktifkan Pengaturan Diagnostik pada sumber daya Application Insights klasik Anda.

  2. Dari tampilan sumber daya Application Insights Anda, di bawah judul "Konfigurasikan" , pilih "Ekspor berkelanjutan".

    Cuplikan layar yang memperlihatkan item menu Ekspor berkelanjutan.

  3. Pilih Nonaktifkan.

    Cuplikan layar yang memperlihatkan tombol Nonaktifkan ekspor berkelanjutan.

    • Setelah memilih Nonaktifkan, Anda dapat kembali ke UI migrasi. Jika halaman Edit ekspor berkelanjutan meminta Anda bahwa pengaturan Anda tidak disimpan, pilih OK. Perintah ini tidak berkaitan dengan menonaktifkan atau mengaktifkan ekspor berkelanjutan.

    • Setelah memigrasikan sumber daya Application Insights, Anda dapat menggunakan pengaturan diagnostik untuk menggantikan fungsionalitas yang digunakan untuk ekspor berkelanjutan. Pilih Pengaturan>diagnostik Tambahkan pengaturan diagnostik di sumber daya Application Insights Anda. Anda dapat memilih semua tabel, atau subset tabel, untuk mengarsipkan ke akun penyimpanan atau melakukan streaming ke Azure Event Hubs. Untuk informasi selengkapnya tentang pengaturan diagnostik, lihat panduan pengaturan diagnostik Azure Monitor.

Pengaturan retensi

Pesan peringatan: "Pengaturan retensi Application Insights yang disesuaikan tidak berlaku untuk data yang dikirim ke ruang kerja. Anda perlu mengonfigurasi ulang secara terpisah."

Anda tidak perlu membuat perubahan apa pun sebelum bermigrasi. Pesan ini mengingatkan Anda bahwa pengaturan retensi Application Insights Anda saat ini tidak diatur ke periode retensi 90 hari default. Pesan peringatan ini berarti Anda mungkin ingin mengubah pengaturan retensi untuk ruang kerja Analitik Log Anda sebelum bermigrasi dan mulai menyerap data baru.

Anda dapat memeriksa pengaturan retensi saat ini untuk Analitik Log di bawah Penggunaan Pengaturan>dan perkiraan biaya>Retensi Data di UI Analitik Log. Pengaturan ini memengaruhi berapa lama data baru yang diserap disimpan setelah Anda memigrasikan sumber daya Application Insights Anda.

Perubahan sumber daya berbasis ruang kerja

Sebelum pengenalan sumber daya Application Insights berbasis ruang kerja, data Application Insights disimpan secara terpisah dari data log lainnya di Azure Monitor. Keduanya didasarkan pada Azure Data Explorer dan menggunakan Bahasa Kueri (KQL) Kusto yang sama. Data sumber daya Application Insights berbasis ruang kerja disimpan di ruang kerja Log Analytics, bersama dengan data pemantauan dan data aplikasi lainnya. Pengaturan ini menyederhanakan konfigurasi Anda. Anda dapat menganalisis data di beberapa solusi dengan lebih mudah dan menggunakan kemampuan ruang kerja.

Struktur data klasik

Struktur ruang kerja Analitik Log dijelaskan dalam gambaran umum ruang kerja Analitik Log. Untuk aplikasi klasik, data tidak disimpan di ruang kerja Log Analytics. Ini menggunakan bahasa kueri yang sama. Anda membuat dan menjalankan kueri dengan menggunakan alat Analitik Log yang sama di portal Azure. Item data untuk aplikasi klasik disimpan secara terpisah satu sama lain. Struktur umumnya sama dengan aplikasi berbasis ruang kerja meskipun nama tabel dan kolom berbeda.

Catatan

Pengalaman Application Insights klasik mencakup kompatibilitas mundur untuk kueri sumber daya, buku kerja, dan pemberitahuan berbasis log Anda. Untuk mengkueri atau menampilkan struktur atau skema tabel berbasis ruang kerja baru, pertama-tama buka ruang kerja Analitik Log Anda. Selama pratinjau, memilih Log di panel Application Insights memberi Anda akses ke pengalaman kueri Application Insights klasik. Untuk informasi selengkapnya, lihat Cakupan kueri.

Diagram yang menunjukkan struktur Azure Monitor Logs untuk Application Insights.

Struktur Tabel

Nama tabel warisan Nama tabel baru Deskripsi
availabilityResults AppAvailabilityResults Data ringkasan dari pengujian ketersediaan.
browserTimings AppBrowserTimings Data tentang performa klien, seperti waktu yang digunakan untuk memproses data masuk.
dependensi AppDependencies Panggilan dari aplikasi ke komponen lain (termasuk komponen eksternal) yang direkam melalui TrackDependency(). Contohnya adalah panggilan ke REST API atau database atau sistem file.
customEvents AppEvents Peristiwa kustom yang dibuat oleh aplikasi Anda.
customMetrics AppMetrics Metrik kustom yang dibuat oleh aplikasi Anda.
pageViews AppPageViews Data tentang setiap tampilan situs web dengan informasi browser.
performanceCounters AppPerformanceCounters Pengukuran performa dari sumber daya komputasi yang mendukung aplikasi. Contohnya adalah penghitung kinerja Windows.
permintaan AppRequests Permintaan yang diterima oleh aplikasi Anda. Misalnya, catatan permintaan terpisah dicatat untuk setiap permintaan HTTP yang diterima aplikasi web Anda.
pengecualian AppExceptions Pengecualian yang dilemparkan oleh runtime aplikasi. Menangkap pengecualian sisi server dan sisi klien (browser).
jejak AppTraces Log terperinci (jejak) yang dipancarkan melalui kode aplikasi/kerangka kerja pengelogan yang direkam melalui TrackTrace().

Perhatian

Tunggu telemetri baru di Analitik Log sebelum mengandalkannya. Setelah memulai migrasi, telemetri terlebih dahulu masuk ke Application Insights Klasik. Penyerapan telemetri dialihkan ke Analitik Log dalam waktu 24 jam. Setelah selesai, Analitik Log hanya mengambil telemetri baru.

Skema tabel

Bagian berikut menunjukkan pemetaan antara nama properti klasik dan nama properti Application Insights berbasis ruang kerja baru. Gunakan informasi ini untuk mengonversi kueri apa pun dengan menggunakan tabel warisan.

Sebagian besar kolom memiliki nama yang sama dengan kapitalisasi yang berbeda. KQL peka huruf besar/kecil, jadi Anda perlu mengubah setiap nama kolom bersama dengan nama tabel dalam kueri yang ada. Kolom dengan perubahan selain kapitalisasi disorot. Anda masih dapat menggunakan kueri Application Insights klasik Anda di panel Log sumber daya Application Insights Anda, meskipun itu adalah sumber daya berbasis ruang kerja. Nama properti baru diperlukan saat Anda mengkueri dari dalam konteks pengalaman ruang kerja Analitik Log.

AppAvailabilityResults

Tabel warisan: availabilityResults

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
customMeasurements dinamis Pengukuran Dinamis
durasi real DurationMs real
id string Id string
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis String
lokasi string Lokasi string
pesan string Pesan string
nama string Nama string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
performanceBucket string PerformanceBucket string
sdkVersion string SDKVersion string
session_Id string SessionId string
size real Ukuran real
success string Berhasil Bool
rentang waktu datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppBrowserTimings

Tabel warisan: browserTimings

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
customMeasurements dinamis Pengukuran Dinamis
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis string
nama string Nama datetime
networkDuration real NetworkDurationMs real
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
performanceBucket string PerformanceBucket string
processingDuration real ProcessingDurationMs real
receiveDuration real ReceiveDurationMs real
sdkVersion string SDKVersion string
sendDuration real SendDurationMs real
session_Id string SessionId string
rentang waktu datetime TimeGenerated datetime
totalDuration real TotalDurationMs real
url string URL string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppDependencies

Tabel warisan: dependensi

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
customMeasurements dinamis Pengukuran Dinamis
data string Data string
durasi real DurationMs real
id string Id string
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis String
nama string Nama string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
performanceBucket string PerformanceBucket string
resultCode string ResultCode string
sdkVersion string SDKVersion string
session_Id string SessionId string
success string Berhasil Bool
target string Target string
rentang waktu datetime TimeGenerated datetime
jenis string DependencyType string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppEvents

Tabel warisan: customEvents

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
customMeasurements dinamis Pengukuran Dinamis
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis string
nama string Nama string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
rentang waktu datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppMetrics

Tabel warisan: customMetrics

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
iKey string IKey string
itemId string (dihapus)
itemType string Jenis string
nama string Nama string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
rentang waktu datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string
value real (dihapus)
valueCount int ItemCount int
valueMax real Maks real
valueMin real Min real
valueSum real Jumlah total real
valueStdDev real (dihapus)

Catatan

Versi lama SDK Application Insights digunakan untuk melaporkan penyimpangan standar (valueStdDev) dalam pra-agregasi metrik. Karena adopsi dalam analisis metrik ringan, bidang dihapus dan tidak lagi diagregasi oleh SDK. Jika nilai diterima oleh titik akhir pengumpulan data Application Insights, nilai tersebut dihilangkan selama penyerapan dan tidak dikirim ke ruang kerja Analitik Log. Jika Anda ingin menggunakan simpang siur standar dalam analisis Anda, gunakan kueri terhadap peristiwa mentah Application Insights.

AppPageViews

Tabel warisan: pageViews

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
customMeasurements dinamis Pengukuran Dinamis
durasi real DurationMs real
id string Id string
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis String
nama string Nama string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
performanceBucket string PerformanceBucket string
sdkVersion string SDKVersion string
session_Id string SessionId string
rentang waktu datetime TimeGenerated datetime
url string URL string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppPerformanceCounters

Tabel warisan: performanceCounters

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
category string Kategori string
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
penghitung string (dihapus)
customDimensions dinamis Properti Dinamis
iKey string IKey string
instance string Instans string
itemId string (dihapus)
itemType string Jenis string
nama string Nama string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
rentang waktu datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string
value real Nilai real

AppRequests

Tabel warisan: permintaan

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti Dinamis
customMeasurements dinamis Pengukuran Dinamis
durasi real DurationMs Riil
id string Id String
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis String
nama string Nama String
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
performanceBucket string PerformanceBucket String
resultCode string ResultCode String
sdkVersion string SDKVersion string
session_Id string SessionId string
sumber string Sumber String
success string Berhasil Bool
rentang waktu datetime TimeGenerated datetime
url string URL String
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppExceptions

Tabel warisan: pengecualian

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
rakitan string Rakitan string
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti dinamis
customMeasurements dinamis Pengukuran dinamis
detail dinamis Detail dinamis
handledAt string HandledAt string
iKey string IKey string
innermostAssembly string InnermostAssembly string
innermostMessage string InnermostMessage string
innermostMethod string InnermostMethod string
innermostType string InnermostType string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis string
pesan string Pesan string
metode string Metode string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
outerAssembly string OuterAssembly string
outerMessage string OuterMessage string
outerMethod string OuterMethod string
outerType string OuterType string
problemId string ProblemId string
sdkVersion string SDKVersion string
session_Id string SessionId string
severityLevel int SeverityLevel int
rentang waktu datetime TimeGenerated datetime
jenis string ExceptionType string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppTraces

Tabel warisan: jejak

ApplicationInsights Jenis LogAnalytics Jenis
appId string ResourceGUID string
application_Version string AppVersion string
appName string (dihapus)
client_browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIp string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dinamis Properti dinamis
customMeasurements dinamis Pengukuran dinamis
iKey string IKey string
itemCount int ItemCount int
itemId string (dihapus)
itemType string Jenis string
pesan string Pesan string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string SyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
severityLevel int SeverityLevel int
rentang waktu datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string