Paket kueri di Azure Monitor Logs

Paket kueri bertindak sebagai kontainer untuk kueri log di Azure Monitor. Mereka memungkinkan Anda menyimpan kueri log dan membagikannya di seluruh ruang kerja dan konteks lain di Analitik Log.

Izin

Anda dapat mengatur izin pada paket kueri saat Anda menampilkannya di portal Azure. Anda memerlukan izin berikut untuk menggunakan paket kueri:

• Pembaca: Pengguna dapat melihat dan menjalankan semua kueri dalam paket kueri.

• Kontributor: Pengguna dapat mengubah kueri yang sudah ada dan menambahkan kueri baru ke paket kueri.

  Penting

  Saat pengguna perlu membuat paket kueri, tetapkan Kontributor Analitik Log pengguna di tingkat Grup Sumber Daya.

Menampilkan paket kueri

Anda dapat menampilkan dan mengelola paket kueri di portal Azure dari menu Paket kueri Log Analytics. Pilih paket kueri untuk menampilkan dan mengedit izinnya. Artikel ini menjelaskan cara membuat paket kueri dengan menggunakan API.

Paket kueri default

Azure Monitor secara otomatis membuat paket kueri yang disebut DefaultQueryPack di setiap langganan dalam grup sumber daya yang dipanggil LogAnalyticsDefaultResources saat Anda menyimpan kueri pertama Anda. Anda dapat menyimpan kueri ke paket kueri ini atau membuat paket kueri lain tergantung pada kebutuhan Anda.

Menggunakan beberapa paket kueri

Paket kueri default cukup bagi sebagian besar pengguna untuk menyimpan dan menggunakan kembali kueri. Anda mungkin ingin membuat beberapa paket kueri untuk pengguna di organisasi Anda jika, misalnya, Anda ingin memuat serangkaian kueri yang berbeda di sesi Analitik Log yang berbeda dan memberikan izin yang berbeda untuk kumpulan kueri yang berbeda.

Saat membuat paket kueri baru, Anda bisa menambahkan tag yang mengklasifikasikan kueri berdasarkan kebutuhan bisnis Anda. Misalnya, Anda dapat menandai paket kueri untuk menghubungkannya ke departemen tertentu di organisasi Anda atau untuk tingkat keparahan masalah yang dimaksudkan untuk ditangani oleh kueri yang disertakan. Dengan menggunakan tag, Anda dapat membuat serangkaian kueri yang berbeda yang ditujukan untuk set pengguna yang berbeda dan situasi yang berbeda.

Untuk menambahkan paket kueri ke ruang kerja Analitik Log Anda:

1. Buka Analitik Log dan pilih Kueri di sudut kanan atas.
2. Di sudut kiri atas pada dialog Kueri, di samping Paket kueri, klik Pilih paket kueri atau 0 dipilih.
3. Pilih paket kueri yang ingin Anda tambahkan ke ruang kerja.

Membuat paket kueri

Anda dapat membuat paket kueri dengan menggunakan REST API atau dari panel paket kueri Analitik Log di portal Azure. Untuk membuka panel paket kueri Analitik Log di portal, pilih Semua layanan>Lainnya.

Membuat token

Anda harus memiliki token untuk autentikasi permintaan API. Ada beberapa metode untuk mendapatkan token. Salah satu metodenya adalah menggunakan armclient.

Pertama, masuk ke Azure dengan menggunakan perintah berikut:

armclient login

Kemudian buat token dengan menggunakan perintah berikut. Token secara otomatis disalin ke clipboard sehingga Anda dapat menempelkannya ke alat lain.

armclient token

Membuat payload

Payload permintaan adalah JSON yang menentukan satu atau beberapa kueri dan lokasi tempat paket kueri harus disimpan. Nama paket kueri ditentukan dalam permintaan API yang dijelaskan di bagian berikutnya.

{
    "location": "eastus",
    "properties":
    {
        "displayName": "Query name that will be displayed in the UI",
        "description": "Query description that will be displayed in the UI",
        "body": "<<query text, standard KQL code>>",
        "related": {
            "categories": [
                "workloads"
            ],
            "resourceTypes": [
                "microsoft.insights/components"
            ],
            "solutions": [
                "logmanagement"
            ]
        },
        "tags": {
            "Tag1": [
                "Value1",
                "Value2"
            ]
        }
    }
}

Setiap kueri dalam paket kueri memiliki properti berikut:

Buat permintaan

Gunakan permintaan berikut untuk membuat paket kueri baru dengan menggunakan REST API. Permintaan harus menggunakan otorisasi token pembawa. Jenis konten harus .application/json

POST https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Insights/querypacks/my-query-pack?api-version=2019-09-01

Gunakan alat yang dapat mengirimkan permintaan REST API, seperti curl, Insomnia, atau Bruno, untuk mengirimkan permintaan dengan menggunakan payload yang dijelaskan di bagian sebelumnya. ID kueri akan dibuat dan dikembalikan dalam payload.

Memperbarui paket kueri

Untuk memperbarui paket kueri, kirimkan permintaan berikut dengan payload yang diperbarui. Perintah ini memerlukan ID paket kueri.

POST https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Insights/querypacks/my-query-pack/queries/query-id/?api-version=2019-09-01

Langkah berikutnya

Lihat Menggunakan kueri di Log Analytics Azure Monitor untuk melihat bagaimana pengguna berinteraksi dengan paket kueri di Log Analytics.