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 או את שניהם.

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

מדד v1 ‏ (agent.googleapis.com/iis/)	מדד v2 ‏ (workload.googleapis.com/)
current_connections	iis.connection.active
network/transferred_bytes_count	iis.network.io
new_connection_count	iis.connection.attempt.count
request_count	iis.request.count

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

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

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

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

הגדרת סוכן התפעול ל-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 ובחירה באפשרות הפעלה כמנהל מערכת.
3. כדי להפעיל מחדש את הסוכן, מריצים את פקודת PowerShell הבאה:

   Restart-Service google-cloud-ops-agent -Force
   

4. כדי לוודא שהסוכן הופעל מחדש, מריצים את הפקודה הבאה ומוודאים שהרכיבים Metrics Agent ו-Logging Agent הופעלו:

   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 חדש, יכול להיות ש-IIS לא ידווח על מדדים באופן מיידי. יכול להיות שבמסוף Server Manager שמותקן ב-Windows Server, הסטטוס של השרת שלכם יהיה Online - Performance Counters not started בעמודה Manageability.

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

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

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

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

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

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

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

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

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

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

  • נותנים למקלט שם אחר חוץ מ-iis, למשל iis_v2.
  • מגדירים את השדה 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  (project) IIS open connections
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  (project) IIS connections
CUMULATIVE, INT64, 1 aws_ec2_instance gce_instance	חיבורים שנפתחו ל-IIS. נדגם כל 60 שניות.
request_count ^GA  (project) IIS requests
CUMULATIVE, INT64, 1 aws_ec2_instance gce_instance	בקשות שנשלחו אל IIS. נדגם כל 60 שניות. http_method: שיטת HTTP (post, put, get, delete, option, trace, head)

הטבלה נוצרה בתאריך 2026-02-26 בשעה 23:38:29 לפי שעון 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 יתחיל לאסוף נתוני טלמטריה.

כדי לוודא שיומני IIS נשלחים אל Cloud Logging, מבצעים את הפעולות הבאות:

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

   כניסה אל 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. בסרגל הכלים של חלונית הכלי ליצירת שאילתות, לוחצים על הלחצן ששמו הוא  MQL או  PromQL.
3. מוודאים שהאפשרות 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 מתחיל לאסוף נתונים של מדדים.

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

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

1. במסוף Google Cloud , עוברים לדף  Dashboards:

   מעבר אל מרכזי בקרה

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

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

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

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

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

   עוברים אל Integrations

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

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

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

מידע נוסף על השימוש בדף Integrations (שילובים) זמין במאמר ניהול שילובים.

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

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

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

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

   עוברים אל Integrations

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

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

   2. בקטע הגדרת התראות, בוחרים ערוץ התראות אחד או יותר. יש לכם אפשרות להשבית את השימוש בערוצי התראות, אבל אם תעשו את זה, מדיניות ההתראות שלכם תופעל ללא התראות. אפשר לבדוק את הסטטוס שלהם בדף 'מעקב', אבל לא תקבלו התראות.

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

   3. לוחצים על יצירת מדיניות.

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

מידע נוסף על השימוש בדף Integrations (שילובים) זמין במאמר ניהול שילובים.

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

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