Internet Information Services

השילוב של Internet Information Services ‏ (IIS) אוסף נתוני טלמטריה משרתי האינטרנט של IIS. המדדים מספקים מידע על החיבור וגם נתונים על הבייטים שהועברו. השילוב גם אוסף מידע מיומני הגישה.

מידע נוסף על IIS זמין במסמכי התיעוד של Internet Information Services.

לפני שמתחילים

בגרסה 2.15.0 של סוכן תפעול נוספה תמיכה בקבוצה חדשה של מדדי IIS באמצעות הקידומת workload.googleapis.com/. כדי לאסוף את המדדים האלה, צריך להגדיר את הסוכן כמו שמתואר בהגדרה לדוגמה.

סוכן תפעול תמיד תמך בקבוצה מוגבלת של מדדי IIS, שמשתמשים בקידומת agent.googleapis.com/iis/. אין צורך בהגדרות נוספות כדי לאסוף את המדדים האלה במכונות וירטואליות של Windows.

במסמך הזה, המדדים עם הקידומת agent נקראים מדדי v1, והמדדים עם הקידומת workload נקראים מדדי v2. בקטע מה מנוטר מופיעות טבלאות של המדדים האלה.

החל מגרסה 2.15.0 של סוכן תפעול, אפשר להגדיר את הסוכן כך שיאסוף מדדים של גרסה 1, מדדים של גרסה 2 או את שניהם.

דרישות מוקדמות

כדי לאסוף נתוני טלמטריה של IIS, צריך להתקין את סוכן התפעול:

  • למדדים בגרסה 1, צריך להתקין את גרסה 1.0.0 ואילך.
  • למדדים בגרסה 2, צריך להתקין את גרסה 2.15.0 ואילך
  • כדי להשתמש ביומנים, צריך להתקין את גרסה 2.14.0 ואילך.

השילוב הזה תומך בגרסאות 8.5 ו-10.0 של IIS.

הגדרת סוכן התפעול ל-IIS

פועלים לפי ההוראות במדריך להגדרת Ops Agent, מוסיפים את הרכיבים הנדרשים לאיסוף נתוני טלמטריה ממכונות IIS ומפעילים מחדש את הסוכן.

הגדרה לדוגמה

הפקודות הבאות יוצרות את ההגדרות לאיסוף וקליטה של נתוני טלמטריה ל-IIS:

$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 an empty config.yaml file if it doesn't exist.
$configFilePath  = 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml'

if (-not (Test-Path -Path $configFilePath -PathType Leaf)) {
    New-Item -ItemType File -Path $configFilePath -Force | Out-Null
}

# 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
"

if (Get-Service google-cloud-ops-agent* -ErrorAction SilentlyContinue) {
  (Get-Service google-cloud-ops-agent*).WaitForStatus('Running', '00:03:00')
}

כדי שהשינויים האלה ייכנסו לתוקף, צריך להפעיל מחדש את Ops Agent:

  1. מתחברים למכונה באמצעות RDP או כלי דומה ונכנסים ל-Windows.
  2. פותחים טרמינל ב-PowerShell עם הרשאות אדמין: לוחצים לחיצה ימנית על הסמל של PowerShell ובוחרים באפשרות Run as Administrator.
  3. כדי להפעיל מחדש את הסוכן, מריצים את הפקודה הבאה ב-PowerShell: 
    Restart-Service google-cloud-ops-agent -Force
  4. כדי לוודא שהסוכן הופעל מחדש, מריצים את הפקודה הבאה ובודקים שהרכיבים Metrics Agent ו-סוכן Logging הופעלו: 
    Get-Service google-cloud-ops-agent*

המקלט הזה תומך רק בפורמט ברירת המחדל של רישום ביומן של W3C.

הגדרת איסוף היומנים

כדי להטמיע יומני גישה מ-IIS, צריך ליצור מקלטים ליומנים ואז ליצור צינור עיבוד נתונים למקלטים החדשים.

כדי להגדיר מקלט ליומני iis_access, צריך לציין את השדות הבאים:

שדה ברירת מחדל תיאור
exclude_paths [] רשימה של תבניות נתיבים של מערכת קבצים שצריך להחריג מהקבוצה שתואמת ל-include_paths.
include_paths ['C:\inetpub\logs\LogFiles\W3SVC1\u_ex*'] רשימה של נתיבים במערכת הקבצים לקריאה על ידי מעקב אחרי כל קובץ. אפשר להשתמש בתו כללי לחיפוש (*) בנתיבים, לדוגמה: C:\inetpub\logs\LogFiles\W3SVC1\u_ex*.
type הערך חייב להיות iis_access.
record_log_file_path false אם מגדירים את הערך true, הנתיב לקובץ הספציפי שממנו התקבלה רשומת היומן מופיע ברשומת היומן של הפלט כערך של התווית agent.googleapis.com/log_file_path. כשמשתמשים בתו כללי לחיפוש, רק הנתיב של הקובץ שממנו התקבל הרשומה מתועד.
wildcard_refresh_interval 60s המרווח שבו מתבצע רענון של נתיבי קבצים עם תווים כלליים לחיפוש במדיניות include_paths. מצוין כמרווח זמן שניתן לניתוח על ידי time.ParseDuration, לדוגמה 30s או 2m. המאפיין הזה יכול להיות שימושי במקרים של קצב העברת נתונים גבוה, שבהם קובצי היומן עוברים רוטציה מהר יותר מהמרווח שמוגדר כברירת מחדל.

מה מתועד ביומן

הערך של logName נגזר ממזהי המקבלים שצוינו בהגדרה. השדות המפורטים ב-LogEntry הם:

ביומני iis_access יש את השדות הבאים ב-LogEntry:

שדה סוג תיאור
httpRequest.referer מחרוזת התוכן של הכותרת Referer
httpRequest.remoteIp מחרוזת כתובת ה-IP של הלקוח ששלח את הבקשה
httpRequest.requestMethod מחרוזת שיטת HTTP
httpRequest.requestUrl מחרוזת כתובת ה-URL של הבקשה (בדרך כלל רק החלק של הנתיב בכתובת ה-URL)
httpRequest.serverIp מחרוזת כתובת ה-IP והיציאה של השרת שהתבקשו
httpRequest.status מספר קוד מצב HTTP
httpRequest.userAgent מחרוזת התוכן של הכותרת User-Agent
jsonPayload.sc_substatus מספר קוד השגיאה של סטטוס המשנה
jsonPayload.sc_win32_status מספר קוד הסטטוס של Windows
jsonPayload.time_taken מספר משך הזמן של הפעולה, באלפיות השנייה
jsonPayload.user מחרוזת שם המשתמש המאומת של הבקשה
timestamp מחרוזת (Timestamp) השעה שבה הבקשה התקבלה

הגדרת איסוף מדדים בגרסה 1

‫סוכן תפעול במכונה וירטואלית של Microsoft Windows אוסף באופן אוטומטי מדדים של IIS v1. אין צורך לקבוע הגדרות נוספות בשביל זה. כדי לאסוף רק מדדים של גרסה 2, קראו את המאמר הגדרת איסוף מדדים של גרסה 2.

אחרי שמגדירים מכונה חדשה של IIS, יכול להיות שהיא לא תדווח מיד על מדדים. אם אתם משתמשים במסוף Server Manager שמותקן ב-Windows Server, יכול להיות שבעמודה Manageability הסטטוס של השרת הוא Online - Performance Counters not started.

דרך אחת להפעיל את IIS כדי ליצור מדדים היא ללחוץ לחיצה ימנית על שרת ה-IIS במסוף Server Manager ולבחור באפשרות Start Performance Counters. השרת אמור להתחיל לשלוח מדדים לסוכן תפעול.

הגדרת איסוף מדדים בגרסה 2

כדי להטמיע מדדים בגרסה 2 מ-IIS, צריך ליצור מקלט למדדים ש-IIS מייצר ואז ליצור צינור עיבוד נתונים למקלט החדש.

המקלט הזה לא תומך בשימוש בכמה מופעים בהגדרות האישיות, למשל כדי לעקוב אחרי כמה נקודות קצה (endpoints). כל המכונות האלה כותבות לאותה סדרת זמנים, ול-Cloud Monitoring אין דרך להבחין ביניהן.

כדי להגדיר מקלט למדדי iis, צריך לציין את השדות הבאים:

שדה ברירת מחדל תיאור
collection_interval ‫60 שנ' ערך time.Duration, כמו 30s או 5m.
receiver_version גרסת המדדים שנאספו. צריך להשתמש ב-2 כדי לאסוף מדדים של גרסה 2.
type הערך חייב להיות iis.

כברירת מחדל, המדדים של גרסה 1 נאספים באופן אוטומטי. אתם יכולים להוסיף למדדים של גרסה 1 את המדדים של גרסה 2, או להחליף את המדדים של גרסה 1 במדדים של גרסה 2.

  • כדי לאסוף רק מדדים של גרסה 2, מבצעים את הפעולות הבאות:

    • נותנים שם למקלט iis.
    • מגדירים את השדה type לערך iis.
    • מגדירים את השדה receiver_version לערך 2.
    • משתמשים במקלט הזה בצינור עיבוד הנתונים של default_pipeline. ההגדרה הזו מבטלת את ההגדרה המובנית של מקלט iis.

  • כדי לאסוף מדדים גם מגרסה 1 וגם מגרסה 2:

    • נותנים למקלט שם אחר, למשל iis_v2 במקום iis.
    • מגדירים את השדה type לערך iis.
    • מגדירים את receiver_version לערך 2.
    • משתמשים במקלט הזה בצינור עיבוד הנתונים החדש. ההגדרה הזו מוסיפה מקלט v2 במקום לשנות את המקלט המובנה. הסקריפט בהגדרה לדוגמה משתמש בגישה הזו.

מה נמצא במעקב

החל מגרסה 2.15.0, סוכן תפעול יכול לאסוף שתי קבוצות שונות של מדדים:

  • המדדים בגרסה 1: agent.googleapis.com/iis/.
  • המדדים בגרסה 2: workload.googleapis.com/.
מדדים בגרסה 1

בטבלה הבאה מפורטים המדדים בגרסה 1 ש-סוכן תפעול אוסף ממכונת IIS.

למחרוזות של "סוג המדד" בטבלה הזו צריך להוסיף את הקידומת agent.googleapis.com/iis/. הקידומת הזו הושמטה מהרשומות בטבלה. כששולחים שאילתה לגבי תווית, צריך להשתמש בקידומת metric.labels., לדוגמה metric.labels.LABEL="VALUE".

סוג המדד שלב ההשקה (רמות היררכיית המשאבים)
השם המוצג
סוג, סוג, יחידה
משאבים במעקב		 תיאור
תוויות
current_connections GA  (פרויקט)
חיבורים פתוחים של IIS
‫GAUGE, DOUBLE, 1
aws_ec2_instance
gce_instance 		חיבורים פתוחים כרגע ל-IIS. נדגם כל 60 שניות.
network/transferred_bytes_count GA  (project)
IIS transferred bytes
‫CUMULATIVE, INT64, By
aws_ec2_instance
gce_instance 		בייטים ברשת שהועברו על ידי IIS. נדגם כל 60 שניות.
direction: כיוון (נשלח, התקבל)
new_connection_count GA  (פרויקט)
חיבורי IIS
‫CUMULATIVE, INT64, 1
aws_ec2_instance
gce_instance 		חיבורים שנפתחו ל-IIS. נדגם כל 60 שניות.
request_count GA  (פרויקט)
בקשות IIS
‫CUMULATIVE, INT64, 1
aws_ec2_instance
gce_instance 		בקשות שנשלחות אל IIS. נדגם כל 60 שניות.
http_method: שיטת HTTP‏ (post, ‏ put, ‏ get, ‏ delete, ‏ option, ‏ trace, ‏ head)

הטבלה נוצרה ב-22 באוקטובר 2026 בשעה 02:44:18 לפי שעון UTC.

מדדים בגרסה 2

בטבלה הבאה מפורטים המדדים בגרסה 2 ש-סוכן תפעול אוסף ממכונת IIS.

סוג המדד 
סוג, סוג
משאבים במעקב		 תוויות
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 		 

אימות ההגדרות האישיות

בקטע הזה מוסבר איך לוודא שהגדרתם נכון את המקלט של IIS. יכול להיות שיעברו דקה או שתיים עד ש-Ops Agent יתחיל לאסוף נתוני טלמטריה.

כדי לוודא שיומני IIS נשלחים ל-Cloud Logging:

  1. נכנסים לדף Logs Explorer ב- במסוף Google Cloud :

    נכנסים לדף Logs Explorer.

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה עם כותרת המשנה Logging.

  2. מזינים את השאילתה הבאה בעורך ולוחצים על Run query: 
    resource.type="gce_instance"
log_id("iis_access")

כדי לוודא שהמדדים של IIS נשלחים ל-Cloud Monitoring:

  1. במסוף Google Cloud , נכנסים לדף  Metrics explorer:

    כניסה לדף Metrics Explorer

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בסרגל הכלים של החלונית query-builder, לוחצים על הלחצן  PromQL.
    • למדדים בגרסה 1, מזינים את השאילתה הבאה בעורך ולוחצים על Run query: 
      {"agent.googleapis.com/iis/request_count", monitored_resource="gce_instance"}
    • למדדים בגרסה 2, מזינים את השאילתה הבאה בעורך ולוחצים על Run: 
      {"workload.googleapis.com/iis.request.count", monitored_resource="gce_instance"}

צפייה בלוח הבקרה

כדי להציג את מדדי IIS, צריך להגדיר תרשים או לוח בקרה. השילוב של IIS כולל לוח בקרה אחד או יותר. כל לוחות הבקרה מותקנים באופן אוטומטי אחרי שמגדירים את השילוב ו-Ops Agent מתחיל לאסוף נתוני מדדים.

אתם יכולים גם לראות תצוגות מקדימות סטטיות של מרכזי הבקרה בלי להתקין את השילוב.

כדי לראות מרכז בקרה שהותקן, מבצעים את הפעולות הבאות:

  1. נכנסים לדף  Dashboards במסוף Google Cloud :

    כניסה לדף Dashboards

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בוחרים בכרטיסייה Dashboard List ואז בקטגוריה Integrations.
  3. לוחצים על השם של מרכז הבקרה שרוצים לראות.

אם הגדרתם שילוב אבל לוח הבקרה לא הותקן, ודאו ש-סוכן תפעול פועל. אם אין נתוני מדדים לתרשים במרכז הבקרה, ההתקנה של מרכז הבקרה נכשלת. אחרי שסוכן תפעול מתחיל לאסוף מדדים, לוח הבקרה מותקן בשבילכם.

כדי לראות תצוגה מקדימה סטטית של מרכז הבקרה:

  1. נכנסים לדף  Integrations במסוף Google Cloud :

    עוברים אל Integrations.

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. לוחצים על המסנן של פלטפורמת הפריסה Compute Engine.
  3. מאתרים את הרשומה של IIS ולוחצים על View Details.
  4. לוחצים על הכרטיסייה מרכזי בקרה כדי לראות תצוגה מקדימה סטטית. אם מרכז הבקרה מותקן, אפשר לעבור אליו בלחיצה על View dashboard.

למידע נוסף על מרכזי בקרה ב-Cloud Monitoring, קראו את המאמר מרכזי בקרה ותרשימים.

מידע נוסף על השימוש בדף Integrations זמין במאמר ניהול אינטגרציות.

התקנת כללי מדיניות התראות

מדיניות ההתראות מנחה את Cloud Monitoring להודיע לכם כשמתקיימים תנאים מסוימים. השילוב של IIS כולל מדיניות התראות אחת או יותר לשימושכם. אפשר לראות ולהתקין את מדיניות ההתראות הזו בדף Integrations ב-Monitoring.

כדי לראות את התיאורים של כללי מדיניות ההתראות הזמינים ולהתקין אותם:

  1. נכנסים לדף  Integrations במסוף Google Cloud :

    עוברים אל Integrations.

    אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. מאתרים את הרשומה של IIS ולוחצים על View Details.
  3. לוחצים על הכרטיסייה התראות. בכרטיסייה הזו מופיעים תיאורים של כללי מדיניות ההתראה הזמינים, וממשק להתקנה שלהם.
  4. התקנת כללי מדיניות התראות. כדי להתקין מדיניות התראות, צריך לספק מידע על המקום שאליו יישלחו ההתראות כשהן יופעלו. כדי להתקין מדיניות התראות:
    1. מרשימת מדיניות ההתראות הזמינה, בוחרים את המדיניות שרוצים להתקין.

    2. בקטע Configure notifications, בוחרים ערוץ התראות אחד או יותר. אתם יכולים להשבית את השימוש בערוצי התראות, אבל אם תעשו את זה, כללי מדיניות ההתראות יופעלו בלי לשלוח התראות. אפשר לבדוק את הסטטוס שלהם ב-Monitoring, אבל לא מקבלים התראות.

      למידע נוסף על ערוצי התראות, קראו את המאמר ניהול ערוצי התראות.

    3. לוחצים על Create Policies.

למידע נוסף על מדיניות התראות ב-Cloud Monitoring, קראו את המאמר מבוא להתראות.

מידע נוסף על השימוש בדף Integrations זמין במאמר ניהול אינטגרציות.

המאמרים הבאים

בסרטון Install the Ops Agent to troubleshoot third-party applications מוסבר איך משתמשים ב-Ansible כדי להתקין את סוכן התפעול, להגדיר אפליקציה של צד שלישי ולהתקין לוח בקרה לדוגמה.