Integrasi Internet Information Services mengumpulkan telemetri dari server web IIS Anda. Metrik ini memberikan informasi koneksi dan juga data tentang byte yang ditransfer. Integrasi tersebut juga mengumpulkan informasi dari log akses.
Untuk informasi selengkapnya tentang IIS, lihat dokumentasi Internet Information Services.
Sebelum memulai
Agen Operasional versi 2.15.0 memperkenalkan dukungan untuk serangkaian metrik IIS baru menggunakan awalan workload.googleapis.com/
. Anda harus mengonfigurasi agen untuk mengumpulkan metrik ini, seperti yang dijelaskan dalam Contoh konfigurasi.
Agen Operasional selalu mendukung serangkaian metrik IIS terbatas; metrik ini menggunakan awalan agent.googleapis.com/iis/
. Tidak diperlukan konfigurasi tambahan untuk mengumpulkan metrik ini di VM Windows.
Dokumen ini merujuk pada metrik berawalan agent
sebagai metrik v1
dan metrik berawalan workload
sebagai metrik v2.
Untuk tabel metrik ini, lihat Apa yang dipantau.
Mulai Agen Operasional versi 2.15.0, Anda dapat mengonfigurasi agen untuk mengumpulkan metrik v1, metrik v2, atau keduanya.
Prasyarat
Untuk mengumpulkan telemetri IIS, Anda harus menginstal Agen Operasional:
- Untuk metrik v1, instal versi 1.0.0 atau yang lebih baru.
- Untuk metrik v2, instal versi 2.15.0 atau yang lebih baru
- Untuk log, instal versi 2.14.0 atau yang lebih tinggi.
Integrasi ini mendukung IIS versi 8.5 dan 10.0.
Mengonfigurasi Agen Operasional untuk IIS
Dengan mengikuti panduan untuk mengonfigurasi Agen Operasi, tambahkan elemen yang diperlukan untuk mengumpulkan telemetri dari instance IIS, dan mulai ulang agen.
Contoh konfigurasi
Perintah berikut akan membuat konfigurasi untuk mengumpulkan dan menyerap telemetri untuk IIS dan memulai ulang Agen Operasional.
Penerima ini hanya mendukung format logging W3C default.
Mengonfigurasi pengumpulan log
Untuk menyerap log akses dari IIS, Anda harus membuat penerima untuk log tersebut, lalu membuat pipeline untuk penerima baru.
Untuk mengonfigurasi penerima log iis_access
Anda, tentukan kolom
berikut:
Kolom | Default | Deskripsi |
---|---|---|
exclude_paths |
[] |
Daftar pola jalur sistem file yang akan dikecualikan dari kumpulan yang cocok dengan include_paths . |
include_paths |
['C:\inetpub\logs\LogFiles\W3SVC1\u_ex*'] |
Daftar jalur sistem file untuk dibaca dengan memberi tail pada setiap file. Karakter pengganti (* ) dapat digunakan di jalur tersebut; misalnya, C:\inetpub\logs\LogFiles\W3SVC1\u_ex* . |
type |
Nilai harus berupa iis_access . |
|
record_log_file_path |
false |
Jika ditetapkan ke true , jalur ke file tertentu tempat data log diperoleh akan muncul di entri log output sebagai nilai label agent.googleapis.com/log_file_path . Saat menggunakan karakter pengganti, hanya jalur file tempat kumpulan data diperoleh yang akan dicatat. |
wildcard_refresh_interval |
60s |
Interval saat jalur file karakter pengganti di include_paths dimuat ulang. Ditentukan sebagai interval waktu yang dapat diuraikan menurut time.ParseDuration , misalnya 30 dtk atau 2 m. Properti ini mungkin berguna untuk throughput logging yang tinggi karena file log dirotasi lebih cepat daripada interval default. |
Apa itu log?
logName
berasal dari ID penerima yang ditentukan dalam konfigurasi.
Kolom mendetail di dalam LogEntry
adalah sebagai berikut.
Log iis_access
berisi kolom berikut di LogEntry
:
Kolom | Jenis | Deskripsi |
---|---|---|
httpRequest.referer |
string | Konten header Referer |
httpRequest.remoteIp |
string | IP klien yang membuat permintaan |
httpRequest.requestMethod |
string | Metode HTTP |
httpRequest.requestUrl |
string | URL Permintaan (biasanya hanya bagian jalur URL) |
httpRequest.serverIp |
string | IP dan port server yang diminta |
httpRequest.status |
angka | Kode status HTTP |
httpRequest.userAgent |
string | Konten header User-Agent |
jsonPayload.sc_substatus |
angka | Kode error substatus |
jsonPayload.sc_win32_status |
angka | Kode status Windows |
jsonPayload.time_taken |
angka | Durasi waktu yang dibutuhkan untuk tindakan, dalam milidetik |
jsonPayload.user |
string | Nama pengguna yang diautentikasi untuk permintaan |
timestamp |
string (Timestamp ) |
Waktu permintaan diterima |
Mengonfigurasi pengumpulan metrik v1
Agen Operasional di VM Microsoft Windows otomatis mengumpulkan metrik IIS v1. Tidak diperlukan konfigurasi tambahan. Untuk mengetahui informasi tentang cara mengumpulkan metrik v2 saja, lihat Mengonfigurasi pengumpulan metrik v2.
Setelah Anda menyiapkan instance IIS baru, IIS mungkin tidak segera melaporkan metrik apa pun. Dengan menggunakan konsol Server Manager yang terinstal di Windows Server, Anda mungkin melihat bahwa server Anda memiliki status Online - Performance Counters not started di kolom Manageability.
Salah satu cara mengaktifkan IIS untuk menghasilkan metrik adalah dengan mengklik kanan server IIS di konsol Server Manager, lalu memilih Start Performance Counters. Server Anda harus mulai mengirimkan metrik ke Agen Operasional.
Mengonfigurasi pengumpulan metrik v2
Untuk menyerap metrik v2 dari IIS, Anda harus membuat penerima untuk metrik yang dihasilkan IIS, lalu membuat pipeline untuk penerima baru.
Penerima ini tidak mendukung penggunaan beberapa instance dalam konfigurasi, misalnya, untuk memantau beberapa endpoint. Semua instance tersebut menulis ke deret waktu yang sama, dan Cloud Monitoring tidak memiliki cara untuk membedakannya.
Untuk mengonfigurasi penerima metrik iis
Anda, tentukan kolom
berikut:
Kolom | Default | Deskripsi |
---|---|---|
collection_interval |
60 dtk | Nilai time.Duration, seperti 30s atau 5m. |
receiver_version |
Versi metrik yang dikumpulkan; gunakan 2 untuk mengumpulkan metrik v2. |
|
type |
Nilai ini harus iis . |
Secara default, metrik v1 dikumpulkan secara otomatis. Anda dapat meningkatkan metrik v1 dengan mengumpulkan metrik v2 juga, atau Anda dapat mengganti metrik v1 untuk hanya mengumpulkan metrik v2.
Untuk mengumpulkan metrik v2 saja, lakukan hal berikut:
- Beri nama penerima Anda
iis
. - Tetapkan kolom
type
keiis
. - Tetapkan kolom
receiver_version
ke2
. - Gunakan penerima ini di pipeline
default_pipeline
Anda. Konfigurasi ini menggantikan konfigurasi bawaan penerimaiis
.
- Beri nama penerima Anda
Untuk mengumpulkan metrik v1 dan v2, lakukan hal berikut:
- Beri nama penerima Anda dengan nama selain
iis
, sepertiiis_v2
. - Tetapkan kolom
type
keiis
. - Setel
receiver_version
ke2
. - Gunakan penerima ini di pipeline baru Anda. Konfigurasi ini menambahkan penerima v2, bukan mengganti penerima bawaan. Skrip dalam Example configuration menggunakan pendekatan ini.
- Beri nama penerima Anda dengan nama selain
Hal yang dipantau
Mulai versi 2.15.0, Agen Operasional dapat mengumpulkan dua kumpulan metrik yang berbeda:
- Metrik v1:
agent.googleapis.com/iis/
. - Metrik v2:
workload.googleapis.com/
.
Metrik V1
Tabel berikut berisi daftar metrik v1 yang dikumpulkan Agen Operasional dari instance IIS.
String "jenis metrik" dalam tabel ini harus diawali
dengan agent.googleapis.com/iis/
. Awalan tersebut telah dihilangkan dari entri dalam tabel.
Saat membuat kueri label, gunakan awalan metric.labels.
; misalnya, metric.labels.LABEL="VALUE"
.
Jenis metrik Tahap peluncuran Nama tampilan |
|
---|---|
Jenis, Tipe, Unit Resource yang dimonitor |
Deskripsi Label |
current_connections
GA
Koneksi terbuka IIS |
|
GAUGE , DOUBLE , 1
aws_ec2_instance gce_instance |
Saat ini membuka koneksi ke IIS. Sampel diambil setiap 60 detik. |
network/transferred_bytes_count
GA
Byte yang ditransfer IIS |
|
CUMULATIVE , INT64 , By
aws_ec2_instance gce_instance |
Byte jaringan yang ditransfer oleh IIS. Sampel diambil setiap 60 detik.
direction :
Arah (dikirim, diterima)
|
new_connection_count
GA
Koneksi IIS |
|
CUMULATIVE , INT64 , 1
aws_ec2_instance gce_instance |
Koneksi dibuka ke IIS. Sampel diambil setiap 60 detik. |
request_count
GA
Permintaan IIS |
|
CUMULATIVE , INT64 , 1
aws_ec2_instance gce_instance |
Permintaan dibuat ke IIS. Sampel diambil setiap 60 detik.
http_method :
Metode HTTP (post, put, dapatkan, hapus, opsi, trace, head)
|
Tabel yang dibuat pada 27-06-2024 pukul 18.22.22 UTC.
Metrik V2
Tabel berikut berisi daftar metrik v2 yang dikumpulkan Agen Operasional dari instance IIS.
Jenis metrik | |
---|---|
Jenis, Jenis Resource yang dipantau |
Label |
workload.googleapis.com/iis.request.count
|
|
CUMULATIVE , INT64 gce_instance |
request
|
workload.googleapis.com/iis.request.rejected
|
|
CUMULATIVE , INT64 gce_instance |
|
workload.googleapis.com/iis.request.queue.count
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/iis.request.queue.age.max
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/iis.network.file.count
|
|
CUMULATIVE , INT64 gce_instance |
direction
|
workload.googleapis.com/iis.network.blocked
|
|
CUMULATIVE , INT64 gce_instance |
|
workload.googleapis.com/iis.network.io
|
|
CUMULATIVE , INT64 gce_instance |
direction
|
workload.googleapis.com/iis.connection.attempt.count
|
|
CUMULATIVE , INT64 gce_instance |
|
workload.googleapis.com/iis.connection.active
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/iis.connection.anonymous
|
|
CUMULATIVE , INT64 gce_instance |
|
workload.googleapis.com/iis.thread.active
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/iis.uptime
|
|
GAUGE , INT64 gce_instance |
Memverifikasi konfigurasi
```
Memverifikasi konfigurasi
Bagian ini menjelaskan cara memverifikasi bahwa Anda telah mengonfigurasi penerima IIS dengan benar. Mungkin diperlukan waktu satu atau dua menit bagi Agen Operasional untuk mulai mengumpulkan telemetri.
Untuk memverifikasi bahwa log IIS dikirim ke Cloud Logging, lakukan hal berikut:
-
Di konsol Google Cloud, buka halaman Logs Explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.
- Masukkan kueri berikut di editor, lalu klik Run query:
resource.type="gce_instance" log_id("iis_access")
Untuk memverifikasi bahwa metrik IIS dikirim ke Cloud Monitoring, lakukan langkah berikut:
-
Di konsol Google Cloud, buka halaman leaderboard Metrics Explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Di toolbar pada panel pembuat kueri, pilih tombol yang namanya adalah code MQL atau code PromQL.
- Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.
- Untuk metrik v1, masukkan kueri berikut dalam editor, lalu
klik Run query:
fetch gce_instance | metric 'agent.googleapis.com/iis/request_count' | every 1m
- Untuk metrik v2, masukkan kueri berikut dalam editor, lalu
klik Run:
fetch gce_instance | metric 'workload.googleapis.com/iis.request.count' | every 1m
Lihat dasbor
Untuk melihat metrik IIS, Anda harus mengonfigurasi diagram atau dasbor. Integrasi IIS mencakup satu atau beberapa dasbor untuk Anda. Semua dasbor akan otomatis diinstal setelah Anda mengonfigurasi integrasi dan Agen Operasional mulai mengumpulkan data metrik.
Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.
Untuk melihat dasbor yang diinstal, lakukan tindakan berikut:
-
Di konsol Google Cloud, buka halaman
Dashboards:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Pilih tab Dashboard List, lalu pilih kategori Integrations.
- Klik nama dasbor yang ingin Anda lihat.
Jika Anda telah mengonfigurasi integrasi, tetapi dasbor belum diinstal, pastikan Agen Operasional sudah berjalan. Jika tidak ada data metrik untuk diagram di dasbor, penginstalan dasbor akan gagal. Setelah Agen Operasional mulai mengumpulkan metrik, dasbor akan diinstal untuk Anda.
Untuk melihat pratinjau statis dasbor, lakukan tindakan berikut:
-
Di Konsol Google Cloud, buka halaman
Integrations:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Klik filter platform deployment Compute Engine.
- Cari entri untuk IIS, lalu klik Lihat Detail.
- Pilih tab Dasbor untuk melihat pratinjau statis. Jika dasbor sudah terinstal, Anda dapat membukanya dengan mengklik View dasbor.
Untuk informasi selengkapnya tentang dasbor di Cloud Monitoring, lihat Dasbor dan diagram.
Untuk mengetahui informasi lebih lanjut tentang cara menggunakan halaman Integrations, lihat Mengelola integrasi.
Instal kebijakan pemberitahuan
Kebijakan pemberitahuan menginstruksikan Cloud Monitoring untuk memberi tahu Anda saat kondisi tertentu terjadi. Integrasi IIS mencakup satu atau beberapa kebijakan pemberitahuan untuk Anda gunakan. Anda dapat melihat dan menginstal kebijakan pemberitahuan ini dari halaman Integrations di Monitoring.
Untuk melihat deskripsi kebijakan pemberitahuan yang tersedia dan menginstalnya, lakukan langkah berikut:
-
Di Konsol Google Cloud, buka halaman
Integrations:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Cari entri untuk IIS, lalu klik Lihat Detail.
- Pilih tab Alerts. Tab ini memberikan deskripsi kebijakan pemberitahuan yang tersedia dan menyediakan antarmuka untuk menginstalnya.
- Instal kebijakan pemberitahuan. Kebijakan pemberitahuan perlu mengetahui tujuan pengiriman notifikasi saat pemberitahuan dipicu. Oleh karena itu, kebijakan ini memerlukan informasi dari Anda untuk penginstalan.
Untuk menginstal kebijakan pemberitahuan, lakukan tindakan berikut:
- Dari daftar kebijakan pemberitahuan yang tersedia, pilih yang ingin Anda instal.
Di bagian Configure notifications, pilih satu atau beberapa saluran notifikasi. Anda memiliki opsi untuk menonaktifkan penggunaan saluran notifikasi. Namun, jika Anda melakukannya, kebijakan pemberitahuan Anda akan diaktifkan secara otomatis. Anda dapat memeriksa statusnya di Monitoring, tetapi Anda tidak akan menerima notifikasi.
Untuk informasi selengkapnya tentang saluran notifikasi, lihat Mengelola saluran notifikasi.
- Klik Create Policy.
Untuk mengetahui informasi selengkapnya tentang kebijakan pemberitahuan di Cloud Monitoring, lihat Pengantar pemberitahuan.
Untuk mengetahui informasi lebih lanjut tentang cara menggunakan halaman Integrations, lihat Mengelola integrasi.
Langkah selanjutnya
Untuk panduan cara menggunakan Ansible untuk menginstal Agen Operasional, mengonfigurasi aplikasi pihak ketiga, dan menginstal contoh dasbor, lihat video Menginstal Agen Operasional untuk memecahkan masalah aplikasi pihak ketiga.