Layanan Informasi Internet

Integrasi Internet Information Services (IIS) mengumpulkan telemetri dari server web IIS Anda. Metrik memberikan informasi koneksi dan juga data tentang byte yang ditransfer. Integrasi ini 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 menggunakan awalan workload.googleapis.com/. Anda harus mengonfigurasi agen untuk mengumpulkan metrik ini, seperti dijelaskan dalam Contoh konfigurasi.

Agen Operasi selalu mendukung kumpulan metrik IIS yang terbatas; metrik ini menggunakan awalan agent.googleapis.com/iis/. Tidak ada tambahan konfigurasi diperlukan untuk mengumpulkan metrik ini di VM Windows.

Dokumen ini mengacu pada metrik berawalan agent sebagai metrik v1 dan metrik awalan workload sebagai metrik v2. Untuk tabel metrik ini, lihat Apa yang dipantau.

Dimulai dengan 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 instal 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 tinggi
  • 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

Mengikuti panduan untuk mengonfigurasi Operasi Agen, tambahkan elemen yang diperlukan untuk mengumpulkan telemetri dari instance IIS, dan memulai ulang agen.

Contoh konfigurasi

Perintah berikut membuat konfigurasi untuk mengumpulkan dan menyerap telemetri untuk IIS dan memulai ulang Agen Operasional.

$ErrorActionPreference = 'Stop'

# This config gets merged with the built-in Ops Agent config, which already
# includes the v1 receiver in the default pipeline.
# Because the v2 receiver here uses a unique ID, it does not overwrite
# the default receiver and so both receivers will be active simultaneously
# during the test.

# Create a back up of the existing file so existing configurations are not lost.
Copy-Item -Path 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' -Destination 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml.bak'

# Configure the Ops Agent.
Add-Content 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' "
metrics:
  receivers:
    iis_v2:
      type: iis
      receiver_version: 2
  service:
    pipelines:
      iispipeline:
        receivers:
          - iis_v2
logging:
  receivers:
    iis_access:
      type: iis_access
  service:
    pipelines:
      iis:
        receivers:
        - iis_access
"

# Stop-Service may fail if the service isn't in a Running state yet.
(Get-Service google-cloud-ops-agent*).WaitForStatus('Running', '00:03:00')
Stop-Service google-cloud-ops-agent -Force
Start-Service google-cloud-ops-agent*

Penerima ini hanya mendukung format logging W3C default.

Mengonfigurasi pengumpulan log

Untuk menyerap log akses dari IIS, Anda harus membuat penerima untuk log, lalu membuat pipeline untuk penerima baru.

Untuk mengonfigurasi penerima log iis_access Anda, tentukan hal berikut bidang:

Kolom Default Deskripsi
exclude_paths [] Daftar pola jalur sistem file yang akan dikecualikan dari kumpulan yang dicocokkan oleh include_paths.
include_paths ['C:\inetpub\logs\LogFiles\W3SVC1\u_ex*'] Daftar jalur sistem file yang akan dibaca dengan mengikuti setiap file. Karakter pengganti (*) dapat digunakan di jalur; 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 data diperoleh yang 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 pada VM Microsoft Windows secara otomatis mengumpulkan Metrik IIS v1. Tidak diperlukan konfigurasi tambahan. Untuk informasi tentang cara mengumpulkan metrik v2 saja, lihat Mengonfigurasi metrik v2 pengumpulan data.

Setelah Anda menyiapkan {i>instance<i} IIS baru, IIS mungkin tidak segera melaporkan metrik apa pun. Menggunakan konsol {i> Server Manager<i} yang disertakan diinstal pada Windows Server, Anda mungkin melihat bahwa server Anda memiliki status Online - Penghitung Performa belum dimulai di kolom Pengelolaan.

Salah satu cara untuk mengaktifkan IIS untuk menghasilkan metrik adalah dengan mengklik kanan server IIS Anda di konsol {i>Server Manager<i} dan pilih Mulai Penghitung Performa. Server Anda akan 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 dan kemudian membuat saluran untuk jaringan penerima.

Penerima ini tidak mendukung penggunaan beberapa instance dalam konfigurasi, misalnya, memantau beberapa endpoint. Semua instance tersebut ditulis ke deret waktu yang sama, dan Cloud Monitoring tidak dapat membedakan keduanya.

Untuk mengonfigurasi penerima metrik iis Anda, tentukan hal berikut bidang:

Kolom Default Deskripsi
collection_interval 60 dtk Nilai time.Duration, seperti 30s atau 5m.
receiver_version Versi metrik yang dikumpulkan; menggunakan 2 untuk mengumpulkan metrik v2.
type Nilai ini harus iis.

Secara default, metrik v1 dikumpulkan secara otomatis. Anda dapat memperkuat metrik v1 dengan mengumpulkan metrik v2 juga, atau Anda dapat mengganti metrik v1 untuk mengumpulkan hanya metrik v2.

  • Untuk mengumpulkan metrik v2 saja, lakukan tindakan berikut:

    • Beri nama penerima Anda iis.
    • Tetapkan kolom type ke iis.
    • Tetapkan kolom receiver_version ke 2.
    • Gunakan penerima ini di pipeline default_pipeline Anda. Konfigurasi ini menggantikan konfigurasi bawaan penerima iis.

  • Untuk mengumpulkan metrik v1 dan v2, lakukan hal berikut:

    • Beri nama penerima Anda selain iis, seperti iis_v2.
    • Tetapkan kolom type ke iis.
    • Setel receiver_version ke 2.
    • Gunakan penerima ini di pipeline baru Anda. Konfigurasi ini menambahkan penerima v2, bukan mengganti penerima penerima. Skrip di Contoh konfigurasi menggunakan pendekatan ini.

Hal yang dipantau

Dimulai dengan versi 2.15.0, Agen Operasional dapat mengumpulkan dua sekumpulan metrik:

  • Metrik v1: agent.googleapis.com/iis/.
  • Metrik v2: workload.googleapis.com/.
Metrik V1

Tabel berikut memberikan 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. Diambil sampelnya 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. Diambil sampelnya setiap 60 detik.
direction: Arah (terkirim, 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, get, delete, option, trace, head)

Tabel dihasilkan pada 10-09-2024 02.16.59 UTC.

Metrik V2

Tabel berikut memberikan daftar metrik v2 yang dikumpulkan Agen Operasional dari instance IIS.

Jenis metrik
Jenis, Jenis
Resource yang dipantau		 Label
workload.googleapis.com/iis.connection.active
GAUGE, INT64
gce_instance 		 
workload.googleapis.com/iis.connection.anonymous
CUMULATIVE, INT64
gce_instance 		 
workload.googleapis.com/iis.connection.attempt.count
CUMULATIVE, INT64
gce_instance 		 
workload.googleapis.com/iis.network.blocked
CUMULATIVE, INT64
gce_instance 		 
workload.googleapis.com/iis.network.file.count
CUMULATIVE, INT64
gce_instance 		direction
workload.googleapis.com/iis.network.io
CUMULATIVE, INT64
gce_instance 		direction
workload.googleapis.com/iis.request.count
CUMULATIVE, INT64
gce_instance 		request
workload.googleapis.com/iis.request.queue.age.max
GAUGE, INT64
gce_instance 		 
workload.googleapis.com/iis.request.queue.count
GAUGE, INT64
gce_instance 		 
workload.googleapis.com/iis.request.rejected
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

Bagian ini menjelaskan cara memverifikasi bahwa Anda telah mengonfigurasi penerima IIS dengan benar. Mungkin Anda perlu waktu satu atau dua menit agar Agen Operasional mulai mengumpulkan telemetri.

Untuk memverifikasi bahwa log IIS dikirim ke Cloud Logging, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman Logs Explorer:

    Buka Logs Explorer

    Jika Anda menggunakan bilah pencarian untuk menemukan halaman ini, kemudian pilih hasil yang sub judulnya Logging.

  2. 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 tindakan berikut:

  1. Di Konsol Google Cloud, buka Halaman Metrics Explorer:

    Buka Metrics explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Di toolbar panel {i>query-builder<i}, pilih tombol yang namanya  MQL atau  PromQL.
  3. Pastikan MQL sudah dipilih tombol Language. Tombol bahasa berada di toolbar yang sama dengan memungkinkan Anda memformat kueri.
    • Untuk metrik v1, masukkan kueri berikut di editor, lalu klik Run query: 
      fetch gce_instance
| metric 'agent.googleapis.com/iis/request_count'
| every 1m
    • Untuk metrik v2, masukkan kueri berikut di editor, lalu klik Run: 
      fetch gce_instance
| metric 'workload.googleapis.com/iis.request.count'
| every 1m

Lihat dasbor

Untuk melihat metrik IIS, Anda harus memiliki diagram atau dasbor dikonfigurasi. Integrasi IIS mencakup satu atau beberapa dasbor untuk Anda. Setiap dasbor otomatis diinstal setelah Anda mengonfigurasi dan Agen Operasional telah mulai mengumpulkan data metrik.

Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.

Untuk melihat dasbor yang terinstal, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman  Dashboards:

    Buka Dasbor

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Pilih tab Dashboard List, lalu pilih Integrations.
  3. Klik nama dasbor yang ingin Anda lihat.

Jika Anda telah mengonfigurasi integrasi, tetapi dasbor belum diinstal, pastikan Agen Operasional berjalan. Ketika tidak ada data metrik untuk bagan di {i>dashboard<i}, penginstalan dasbor gagal. Setelah Ops Agent mulai mengumpulkan metrik, dasbor akan diinstal untuk Anda.

Untuk melihat pratinjau statis dasbor, lakukan tindakan berikut:

  1. Di Konsol Google Cloud, buka  Integrasi halaman:

    Buka Integrations

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Klik filter platform deployment Compute Engine.
  3. Temukan entri untuk IIS lalu klik Lihat Detail.
  4. Pilih tab Dasbor untuk melihat pratinjau statis. Jika sudah diinstal, maka Anda dapat membukanya dengan mengeklik Lihat dasbor.

Untuk mengetahui informasi selengkapnya tentang dasbor di Cloud Monitoring, lihat Dasbor dan diagram.

Untuk mengetahui informasi lebih lanjut tentang cara menggunakan halaman Integrations, lihat Kelola integrasi.

Menginstal 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 Pemantauan.

Untuk melihat deskripsi dari kebijakan pemberitahuan yang tersedia dan menginstalnya, lakukan hal berikut:

  1. Di Konsol Google Cloud, buka  Integrasi halaman:

    Buka Integrations

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Temukan entri untuk IIS lalu klik Lihat Detail.
  3. Pilih tab Alerts. Tab ini memberikan deskripsi tentang kebijakan pemberitahuan yang tersedia dan menyediakan antarmuka untuk menginstal mereka.
  4. Instal kebijakan pemberitahuan. Kebijakan pemberitahuan membutuhkan untuk mengetahui ke mana harus mengirim notifikasi bahwa peringatan itu telah dipicu, sehingga mereka memerlukan informasi dari Anda untuk instalasi. Untuk menginstal kebijakan pemberitahuan, lakukan langkah berikut:
    1. Dari daftar kebijakan pemberitahuan yang tersedia, pilih kebijakan yang ingin Anda instal.

    2. Di bagian Konfigurasi notifikasi, pilih satu atau beberapa saluran notifikasi. Anda memiliki opsi untuk menonaktifkan penggunaan saluran notifikasi, tetapi jika Anda melakukannya, maka pemberitahuan kebijakan diaktifkan secara otomatis. Anda dapat memeriksa statusnya di Pemantauan, tetapi Anda tidak menerima notifikasi.

      Untuk informasi selengkapnya tentang saluran notifikasi, lihat Mengelola saluran notifikasi.

    3. Klik Create Policy.

Untuk informasi selengkapnya tentang kebijakan pemberitahuan di Cloud Monitoring, lihat Pengantar pemberitahuan.

Untuk mengetahui informasi lebih lanjut tentang cara menggunakan halaman Integrations, lihat Kelola integrasi.

Langkah selanjutnya

Untuk panduan tentang 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.