אינך במצב לא מקוון כעת, ממתין לחיבור לאינטרנט

רישום שגיאות ב- Api של HTTP

חשוב: מאמר זה תורגם באמצעות תוכנת תרגום מכונה של Microsoft וייתכן שנערך לאחר מכן על-ידי קהילת Microsoftבאמצעות טכנולוגייתCommunity Translation Framework (CTF) או באמצעות תרגום אנושי. Microsoft מציעה לך גם מאמרים בתרגום אנושי, מאמרים בתרגום מכונה ומאמרים שנערכו על ידי הקהילה כדי לאפשר גישה למאמרים הקיימים במאגר הידע (Knowledge Base) שלMicrosoft בשפות שונות. מאמרים מתורגמים יכולים להכיל שגיאות באוצר המילים, בתחביר או בדקדוק. Microsoft אינה אחראית לחוסר דיוק, שגיאות או נזקים שייגרמו כתוצאה מטעויות בתכנים או משימוש בתכנים על ידי לקוחותיה.

כותרת מאמר זה באנגלית: 820729
תקציר
מאמר זה מתאר את יכולות רישום שגיאות של ממשקי Api של HTTP.

מספר שגיאות המתרחשות ביישום מבוסס-HTTP מטופלות באופן אוטומטי על-ידי ה-API של HTTP במקום המועברים בחזרה יישום עבור טיפול. אופן פעולה זה מתרחש מכיוון התדירות של שגיאות כאלה עשויות אחרת flood יומן אירועים או מטפל היישום.

הנושאים הבאים מתארים היבטים שונים של רישום שגיאות ב- API של HTTP.
  • קביעת התצורה של ה-API של HTTP errorlogging
    שגיאות יומני הרישום הגדרות בקרת ה-API של HTTP, מותר themaximum הגודל של קבצי יומן רישום, ואת המיקום של קבצי יומן רישום.
  • התבנית של HTTP APIerror נכנס
    ה-API של HTTP יוצר קבצי יומן רישום המצייתות עם מוסכמות קובץ יומן רישום של theWorld רחב Web Consortium (W3C). באפשרותך להשתמש בכלים רגילים לנתח קבצי יומן רישום אלה. עם זאת, שלא כמו קבצי יומן רישום W3C, קבצי יומן רישום של API של HTTP לעשות notcontain את שמות העמודות.
  • סוגים של שגיאות נכנס ה-API של HTTP
    ה-API של HTTP רישום שגיאות נפוצות רבות.
מידע נוסף

קביעת תצורה של רישום שגיאות HTTP API

כדי שאנחנו להגדיר רישום שגיאות HTTP API עבורך, עבור אל ה "הנה תיקון קל"מקטע. אם אתה מעדיף לקבוע את התצורה של שגיאת HTTP API רישום בעצמך, עבור אל ה "אני מעדיף לתקן בעצמי"מקטע.

הנה תיקון קל

כדי לתקן בעיה זו באופן אוטומטי, לחץ על הלחצן הורד . בתיבת הדו-שיח הורדת קובץ , לחץ על הפעל או על פתח, ולאחר מכן בצע את השלבים באשף תיקון קל.
  • ייתכן שאשף זה יוצג באנגלית בלבד. עם זאת, התיקון האוטומטי פועל גם עבור גירסאות Windows בשפות אחרות.
  • אם אינך נמצא מול המחשב שבו אירעה הבעיה, שמור את פתרון התיקון הקל בכונן הבזק או בתקליטור ולאחר מכן הפעל אותו במחשב שבו אירעה הבעיה.
בטל רישום שגיאות HTTP API
לאפשר רישום שגיאות HTTP API

אני מעדיף לתקן בעצמי

שלושה ערכי הרישום תחת מפתח HTTP \Parameters לא לשלוט על רישום שגיאות HTTP API. מפתחות אלה ממוקמות במפתח הרישום הבא:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters
הערה המיקום ותבנית של ערכי תצורה עשויים להשתנות בגירסאות מתקדמות יותר של מערכת ההפעלה Windows.

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

הוא לקרוא מידע תצורה בערכי הרישום בעת הפעלת מנהל ההתקן של ה-API של HTTP. לכן, אם תשנה את ההגדרות, עליך לעצור ולאחר מכן הפעל מחדש את מנהל ההתקן לקרוא את הערכים החדשים. כדי לעשות זאת, הקלד את הפקודות הבאות של המסוף:
net stop http
הפקודה net start http
המוסכמה למתן שמות הבא משמש כדי לתת שם את קבצי יומן הרישום:
httperr + מספר רצף + שגובו ושוחזרו בהצלחה
דוגמה: httperr4.log
קבצי יומן רישום הם יחזור לתקנו בעת הגעתן הגודל המרבי המציין ערך הרישום ErrorLogFileTruncateSize . ערך זה אינו יכול להיות קטן מ אחד מגה-בית (MB).

אם התצורה של רישום השגיאות אינו חוקי, או אם כל סוג של כשל מתרחש כאשר ה-API של HTTP צריבת בקבצי יומן הרישום, ה-API של HTTP משתמשת רישום אירועים כדי להודיע למנהלי מערכת רישום שגיאות אינה מתרחשת.

הטבלה הבאה מתארת את ערכי תצורת הרישום.
ערך הרישוםתיאור
EnableErrorLoggingDWORD כי באפשרותך להגדיר כ- TRUE כדי להפעיל רישום שגיאות או כ- FALSE כדי להפוך אותו ללא זמין. ערך ברירת המחדל הוא TRUE.
ErrorLogFileTruncateSizeערך DWORD המציין את הגודל המרבי של קובץ יומן רישום של שגיאה, בבתים. ערך ברירת המחדל הוא 1 מגה-בית (0x100000).

הערה הערך שצוין אינו יכול להיות קטן מערך ברירת המחדל.
ErrorLoggingDirמחרוזת המציינת את התיקיה שבה ה-API של HTTP מעבירה קבצי רישום שלה.

ה-API של HTTP יוצר תיקיית משנה HTTPERR בתיקייה שצוינה ולאחר מכן מאחסן את קבצי יומן הרישום בתיקיית המשנה. תיקיית משנה זו וקבל את קבצי יומן הרישום באותן הגדרות הרשאה. מנהל וחשבונות של המערכת המקומית יש גישה מלאה. אין גישה למשתמשים אחרים.

הבאה היא תיקיית ברירת המחדל כאשר התיקיה אינו מצוין ברישום:
%SystemRoot%\System32\LogFiles

הערה ערך המחרוזת ErrorLoggingDir חייב להיות נתיב מקומי מלא. עם זאת, הוא יכול להכיל % SystemRoot %. אין אפשרות להשתמש בכונן רשת או במיקום משותף ברשת.

בחזרה לראש הדף

תבנית של HTTP API ביומני רישום השגיאות

בדרך כלל, קבצי יומן רישום של שגיאה HTTP API יש באותה התבנית יומני רישום של שגיאה W3C, מלבד העובדה קבצי יומן רישום של שגיאה HTTP API אינם מכילים כותרות עמודה. כל שורה של יומן רישום שגיאות HTTP API רושם שגיאה אחת. השדות מופיעים בסדר מסוים. תו רווח יחיד (0x0020) מפריד בין כל שדה מהשדה הקודם. בכל שדה, סימני חיבור (0x002B) להחליף תווי רווח, טאבים ותווים פקד שאינו ניתן להדפסה.

הטבלה הבאה מזהה את השדות ואת הסדר של שדות רשומת יומן רישום של שגיאה.
שדהתיאור
תאריךהשדה תאריך אחרי תבנית W3C. שדה זה מבוסס על זמן אוניברסלי מתואם (UTC). שדה התאריך הוא תמיד עשרה תווים בתבנית YYYY-MM-DD. לדוגמה, ב- 1 במאי, 2003 מבוטאת כ- 2003-05-01.
זמןשדה שעה אחרי תבנית W3C. שדה זה מבוסס על UTC. השדה זמן הוא תמיד שמונה תווים בצורת MM:HH:SS. לדוגמה, 5 30 PM (UTC) מבוטאת כ- 17:30:00.
כתובת ה-IP של הלקוחכתובת ה-IP של הלקוח המושפעים. הערך בשדה זה יכול להיות כתובת IPv4 או כתובת IPv6. אם כתובת ה-IP של הלקוח היא כתובת IPv6, השדה ScopeId נכלל גם כתובת.
יציאה לקוחמספר היציאה עבור לקוח מושפעת.
כתובת IP של שרתכתובת ה-IP של השרת המושפע. הערך בשדה זה יכול להיות כתובת IPv4 או כתובת IPv6. אם כתובת ה-IP של השרת היא כתובת IPv6, השדה ScopeId נכלל גם כתובת.
יציאת שרתמספר היציאה של השרת המושפע.
גירסת פרוטוקולגירסת פרוטוקול הנמצא בשימוש.

אם החיבור לא נותח מספיק todetermine גירסת פרוטוקול, נעשה שימוש במקף (0x002D) בשם placeholderfor השדה ריק.

אם מספר הגירסה הראשית או את מספר הגירסה המשנית לנתח isgreater מאו שווה ל- 10, הגירסה נרשם כמו HTTP /?.?.
הפועלמצב פועל האחרון המבקשים כלומר לנתח את המעברים. נכללים פעלים לא ידוע, אך כל הפועל יותר מ- 255 בתים נחתך לאורך זה. אם פועל אינה זמינה, נעשה שימוש במקף (0x002D) כמציין מיקום עבור השדה ריק.
CookedURL + שאילתהכתובת ה-URL ואת כל שאילתה המשויך אליו נכנסת כשדה אחד המופרדת על-ידי סימן שאלה (0x3F). שדה זה ייחתך שלו מגבלת האורך של 4,096 בתים.

אם כתובת URL זו היה לנתח ("cooked"), הוא נרשם עם המרת הקידוד המקומי ומטופל כשדה Unicode.

אם כתובת URL זו לא נותח ("cooked") ב- thetime של רישום, הוא מועתק בדיוק, ללא כל המרה Unicode.

אם ה-API של HTTP אין אפשרות לנתח את כתובת URL זו, hyphen(0x002D) משמשת כמציין מיקום עבור השדה ריק.
מצב פרוטוקולמצב פרוטוקול אינו יכול להיות גדול מ- 999.

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

אם המצב הפרוטוקול אינו זמין, hyphen(0x002D) משמשת כמציין מיקום עבור השדה ריק.
SiteIdלא בשימוש בגירסה זו של ה-API של HTTP. מקף מציין מיקום (0x002D) תמיד יופיע בשדה זה.
צירוף מילים של סיבהשדה זה מכיל מחרוזת המזהה את סוג השגיאה אשר נרשם ביומן. הוא לעולם לא להשאיר שדה זה ריק.
שם תורזה שם התור הבקשה.
השורות הבאות לדוגמה הם מתוך יומן רישום שגיאות HTTP API:
2002-07-05 18:45:09 172.31.77.6 2094 172.31.77.6 80 HTTP/1.1 GET /qos/1kbfile.txt 503-ConnLimit 2002-07-05 19:51:59 127.0.0.1 2780 127.0.0.1 80 HTTP/1.1 GET /ThisIsMyUrl.htm 400 – שם מחשב מארח 2002-07-05 19:53:00 127.0.0.1 2894 127.0.0.1 80 HTTP/2.0 GET / 505 - Version_N/S 2002-07-05 20:06:01 172.31.77.6 Timer_MinBytesPerSecond 80-----64388 127.0.0.1
בחזרה לראש הדף

סוגים של שגיאות בהן נכנס ה-API של HTTP

ה-API של HTTP ירשום שגיאה תגובות לקוחות, חיבור להתנתקויות, בקשות יתומים וחיבורים שהושמטו המטופלים באופן שגוי.

הרשימה הבאה מזהה את סוגי שגיאות נכנס ה-API של HTTP:
  • תגובות לקוחות ה-API של HTTP שולח תגובת שגיאה ללקוח, לדוגמה, שגיאת 400 אשר נגרמת על-ידי שגיאת ניתוח מבנה מנשר הבקשה האחרונה שהתקבלה. לאחר ה-API של HTTP שולח תגובה שגיאה, סוגר את החיבור.
  • להתנתקויות חיבור ה-API של HTTP הזמן שהוקצב חיבור. אם בקשה ממתינה הזמן שהוקצב לחיבור whenthe, הבקשה משמש כדי לספק מידע נוסף אודות theconnection ביומן שגיאה.
  • בקשות Orphaned תהליך במצב משתמש נעצר באופן בלתי צפוי כאשר קיימות בקשות בתור עדיין המנותבות לתהליך זה. ה-API של HTTP נכנס בקשות יתומים יומן רישום השגיאות.
סוגי שגיאה ספציפית שמוגדרים על-ידי צירוף מילים סיבה מחרוזות המופיעות תמיד בשם השדה האחרון של כל קו שגיאה. הטבלה הבאה מזהה ביטויים סיבה API של HTTP.
צירוף מילים של סיבהתיאור

AppOfflineאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון שגיאות יישומים גרם ליישום להיות במצב לא מקוון.
AppPoolTimerאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון שתהליך מאגר יישומים עמוס מדי מכדי לטפל בבקשה.
AppShutdownאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון לסגור את היישום באופן אוטומטי בתגובה מדיניות מנהל.
BadRequestשגיאת ניתוח מבנה אירעה בעת עיבוד בקשת.
Client_Resetהחיבור בין הלקוח לשרת נסגר לפני הבקשה היתה אפשרות להקצות תהליך של עובד. הגורם הנפוץ ביותר של התנהגות זו היא שהלקוח סוגר מוקדם מדי את החיבור שלו לשרת.
Connection_Abandoned_By_AppPoolתהליך של עובד מתוך מאגר היישומים באופן בלתי צפוי או מיותמים בקשה ממתינה על-ידי סגירת המזהה הייחודי שלו.
Connection_Abandoned_By_ReqQueueתהליך של עובד מתוך מאגר היישומים באופן בלתי צפוי או מיותמים בקשה ממתינה על-ידי סגירת המזהה הייחודי שלו. ספציפיים ל- Windows Vista וגירסאות מאוחרות יותר וכדי Windows Server 2008 וגירסאות מתקדמות יותר.
Connection_Droppedהחיבור בין הלקוח לשרת נסגר לפני השרת יוכל לשלוח מנת תגובה הסופי שלו. הגורם הנפוץ ביותר של התנהגות זו היא שהלקוח סוגר מוקדם מדי את החיבור שלו לשרת.
Connection_Dropped_List_Fullרשימת שהושמטו חיבורים בין לקוחות לבין השרת אינה מלאה. ספציפיים ל- Windows Vista וגירסאות מאוחרות יותר וכדי Windows Server 2008 וגירסאות מתקדמות יותר.
ConnLimitאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון מגבלת החיבורים ברמת האתר הגיע או חריגה.
Connections_Refusedליבת זיכרון NonPagedPool ירד אל מתחת 20MB והפסיק http. sys מקבל חיבורים חדשים
לא זמיןאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון שמנהל קיבל את היישום במצב לא מקוון.
EntityTooLargeישות חרג מהגודל המרבי המותר.
FieldLengthאירעה חריגה ממגבלת האורך השדה.
אסוררכיב אסורה או רצף נתקלה בעת ניתוח מבנה טקסט.
כותרת עליונהשגיאת ניתוח מבנה אירעה בכותרת עליונה.
שם מחשב מארחשגיאת ניתוח מבנה אירעה בעת עיבוד שם מארח.
פנימיתשגיאת שרת פנימית אירעה (שגיאת HTTP 500).
Invalid_CR/LFגררה לא חוקי או הזנת שורה לא אירעה.
LengthRequiredערך האורך הנדרש היה חסר.
N/Aאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון שאירעה שגיאה פנימית (כגון כשל בהקצאת זיכרון או התנגשות רשימת שיריון של כתובת URL).
N / Iאירעה שגיאת לא מיושם (שגיאת HTTP 501), או (שגיאת HTTP 503) אירעה שגיאת שירות אינו זמין עקב קידוד ההעברה לא ידוע.
מספרשגיאת ניתוח מבנה אירעה בעת עיבוד מספר.
המוקדםהמוקדם הנדרש היה חסר.
QueueFullאירעה שגיאה לא זמין שירות (שגיאת HTTP 503). השירות אינו זמין מכיוון התור בקשת יישום מלא.
RequestLengthאירעה חריגה ממגבלת האורך הבקשה.
Timer_AppPoolהחיבור פג מכיוון בקשה במצב המתנה ארוכה מדי ב תור מאגר יישומים עבור יישום שרת לבטל תור ולעבד אותו. משך הזמן הקצוב זה הוא ConnectionTimeout. כברירת מחדל, ערך זה מוגדר כשתי דקות.
Timer_ConnectionIdleהחיבור פג ולא נשאר פעיל. משך ConnectionTimeout ברירת המחדל הוא שתי דקות.
Timer_EntityBodyהחיבור הסתיים לפני הגיעה לגוף הישות של הבקשה. כשה בקשה בבירור גוף של ישות, ה-API של HTTP מפעילה את שעון העצר של Timer_EntityBody . במבט ראשון, המגבלה של שעון עצר זה מוגדר לערך ConnectionTimeout (בדרך כלל, שתי דקות). בכל פעם זה אינדיקציה נתונים אחר מתקבל על בקשה זו, ה-API של HTTP מאפסת את שעון העצר לספק חיבור שתי דקות יותר (או כל מה שצוין ב- ConnectionTimeout).
Timer_HeaderWaitהחיבור פג מכיוון הכותרת של ניתוח עבור בקשה ארכה זמן רב יותר ממגבלת ברירת המחדל של שתי דקות.
Timer_MinBytesPerSecondהחיבור פג מכיוון הלקוח לא קיבל תגובה במהירות סבירה. שיעור שלח תגובה היה איטי יותר מברירת המחדל של 240 בתים/שניה. ניתן לשלוט באמצעות המאפיין metabase MinFileBytesPerSec .
Timer_ReqQueueהחיבור פג מכיוון בקשה במצב המתנה ארוכה מדי ב תור מאגר יישומים עבור יישום שרת לתור בטל. משך הזמן הקצוב זה הוא ConnectionTimeout. כברירת מחדל, ערך זה מוגדר כשתי דקות. ספציפיים ל- Windows Vista וגירסאות מאוחרות יותר וכדי Windows Server 2008 וגירסאות מתקדמות יותר.
Timer_Responseשמור. אינו בשימוש כעת.
Timer_SslRenegotiationהחיבור פג מכיוון SSL למשא ומתן בין שרת ולקוח לקחה זמן רב יותר פרק הזמן הקצוב המוגדר כברירת מחדל של שתי דקות.
כתובת URLשגיאת ניתוח מבנה אירעה בעת עיבוד כתובת URL.
URL_Lengthכתובת URL של חריגה המירבית המותרת גודל.
הפועלשגיאת ניתוח מבנה אירעה בעת עיבוד פועל.
Version_N/Sאירעה שגיאת גירסה נתמכת לא (שגיאת HTTP 505).

בחזרה לראש הדף
מידע נוסף
לקבלת מידע נוסף אודות אופן הוספת שדות נוספים רישום עבור רישום שגיאות IIS HTTP, לחץ על מספר המאמר הבא כדי להציג את המאמר הרלוונטי מתוך Microsoft Knowledge Base:
832975 מאפיינים נוספים זמינים כעת עבור רישום בקובץ ה-. log # Httperr ב- IIS 6.0 ו- IIS 7.0
fixme-fixit תקנו

אזהרה: מאמר זה תורגם באופן אוטומטי.

מאפיינים:

מזהה פריט: 820729 - סקירה אחרונה: 03/08/2016 04:36:00 - תיקון: 3.0

Windows Server 2008 R2 Standard, Windows Server 2008 R2 Enterprise, Windows Server 2008 Enterprise, Windows Server 2012 R2 Standard, Windows Server 2012 R2 Datacenter, Windows Server 2012 R2 Essentials, Windows Server 2012 R2 for Embedded Systems, Windows Server 2012 R2 Foundation, Windows Server 2012 Standard, Windows Server 2012 Datacenter, Windows Server 2012 Essentials, Windows 10, Windows 10 Enterprise, released in July 2015, Windows 10 Pro, released in July 2015, Windows 10 Version 1511, Windows 8.1, Windows 8.1 Enterprise, Windows 8.1 Pro, Windows 8, Windows 8 Pro, Windows 8 Enterprise, Windows 7 Professional, Windows 7 Enterprise

  • kbhttphandlers kbhttp kbapi kberrmsg kbinfo kbfixme kbmsifixme kbmt KB820729 KbMthe
משוב
/html>