דיווח של יומנים

בדף הזה נסביר איך משתמשים ב-Service Infrastructure כדי לאפשר לשירותים מנוהלים לשלוח יומנים לפרויקטים של בעלים של שירות מנוהל ושל צרכני השירות.

נתונים מובנים או לא מובנים יתקבלו ב-Service Control API מהיומנים, יקובצו ויועברו ל-Cloud Logging. גם אתם וגם המשתמשים בשירותים המנוהלים שלכם תוכלו להשתמש במסוףGoogle Cloud וב-Google API Console כדי להציג את נתוני היומנים, או להשתמש ב-Cloud Logging API כדי לגשת לנתונים באופן פרוגרמטי.

באמצעות Cloud Logging השירות המנוהל יכול ליצור יומנים שישמשו אתכם כמפתחים של השירות המנוהל, ואילו ב-Service Control API אפשר ליצור יומנים שנועדו למשתמשים שלכם. כך המשתמשים יוכלו להבין ולנתח את השימוש שלהם בשירות המנוהל.

הגדרת היומנים

לפני שאתם שולחים את נתוני הרישום ביומן ל-Service Control API, אתם צריכים לציין שלושה קטעי מידע שונים בהגדרות השירות:

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

• משאבים במעקב: משאב במעקב מייצג ישות בענן שמייצרת נתוני רישום ביומן. כדי להגדיר משאב במעקב בהגדרות השירות, עיינו במפרט הטכני monitored_resource.proto. אנחנו מאוד ממליצים להשתמש באותו משאב במעקב גם למעקב וגם לרישום ביומן.

• הגדרות היומן: ההגדרות האלה מאפשרות לכם לציין את המשאב במעקב שמשוייך לכל ערוץ של יומן, ואת הפרויקט של בעלים של שירות מנוהל או של צרכן השירות, שאליו צריך לשלוח את היומן. כדי להגדיר את השיוך ליומן, עיינו במפרט הטכני ב-logging.proto.

בדוגמה הבאה של הגדרות השירות, מגדירים שהיומן activity_log יישלח לצרכן השירות.

# The definition of the monitored resource to be used.
monitored_resources:
- type: library.appspot.com/Branch
  description: A library branch
  display_name: Library Branch
  launch_stage: ALPHA
  labels:
  - key: resource_container
    description: The Google Cloud resource container (ie. project id) for
    the branch.
  - key: location
    description: The Google Cloud region the branch is located.
  - key: branch_id
    description: The ID of the branch.

# The log name to be used.
logs:
- name: activity_log

# The logging configuration.
logging:
  consumer_destinations:
  - monitored_resource: library.appspot.com/Branch
    logs:
    - activity_log

אחרי שאתם מאשרים את ההגדרות האלה, אתם צריכים לדחוף את הגדרות השירות ל-Service Management API. תוכלו להיעזר בהוראות לניהול הגדרות השירות ולניהול השקות של שירותים כדי לקבוע את ההגדרות של המשאבים שבמעקב ב-Cloud Logging.

דיווח של יומנים

אחרי דחיפת הגדרות השירות, תוכלו להפעיל את Service Control API כדי לדווח על רשומות ביומן. בדוגמה הבאה משתמשים בפקודה gcurl כדי להדגים את ההפעלה. במאמר תחילת השימוש ב-Service Control API מוסבר איך מגדירים את מה שדרוש לצורך ההפעלה.

gcurl -d "{
  'operations': [ {
    'operationId': 'e8bf36ef-f9b5-4274-b4f9-079a3731e6e5',
    'operationName': 'New book arrived',
    'consumerId': 'projects/library-consumer',
    'startTime': '`date +%FT%T%:z`',
    'endTime': '`date +%FT%T%:z`',
    'labels': {
      'location': 'us-east1',
      'branch_id': 'my-test-library-branch'
    },
    'logEntries': [ {
      'severity': 'INFO',
      'textPayload': 'new book arrived',
      'name': 'activity_log'
    } ]
  } ]
}" https://servicecontrol.googleapis.com/v1/services/endpointsapis.appspot.com:report