Internet Information Services

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

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

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

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

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

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

החל מגרסה 2.15.0 של Ops Agent, אפשר להגדיר את הסוכן לאיסוף מדדים מגרסה 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

ה-Ops Agent במכונה וירטואלית של 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 (התחלת מוני ביצועים). השרת אמור להתחיל לשלוח מדדים ל-Ops Agent.

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

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

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

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

שדה	ברירת מחדל	תיאור
collection_interval	‫60 שניות	ערך של time.Duration, כמו 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, סוכן Ops יכול לאסוף שני סטים שונים של מדדים:

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

מדדים של גרסה 1

בטבלה הבאה מפורטים המדדים מגרסה 1 שה-Ops Agent אוסף ממופע 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-07-10 בשעה 17:48:44 לפי שעון UTC.

מדדים בגרסה 2

בטבלה הבאה מפורטים המדדים מגרסה 2 שה-Ops Agent אוסף ממופע 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. נכנסים לדף  Metrics explorer במסוף Google Cloud :

   כניסה אל 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 מתחיל לאסוף נתוני מדדים.

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

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

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

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

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

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

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

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

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