יומני ביקורת של ניהול API ב-Apigee

יומני הביקורת של Cloud לניהול API ב-Apigee מאפשרים לעקוב אחרי פעולות ניהול וגישה לנתונים במשאבים, כדי לעזור לכם לעקוב אחרי שינויים בגישה ובהגדרות. אתם יכולים לשלוח שאילתות ליומנים האלה ב-Logs Explorer ולבדוק אילו שיטות של Apigee API Management API יוצרות יומני ביקורת של Cloud.

במאמרים הבאים אפשר לקרוא מידע נוסף על יומני הביקורת של Cloud:

שם השירות

כדי לצפות ביומני הביקורת של ניהול API ב-Apigee:

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

    כניסה לדף Logs Explorer

  2. מעתיקים את השאילתה הבאה ומדביקים אותה בשדה Query של Logs Explorer, ואז לוחצים על Run query.

        protoPayload.serviceName="apim.googleapis.com"

קודי Method לפי סוג ההרשאה

לכל הרשאה ב-IAM יש מאפיין type עם enum שיכול להיות אחד מארבעת הערכים הבאים: ADMIN_READ,‏ ADMIN_WRITE,‏ DATA_READ או DATA_WRITE. כשקוראים ל-method, נוצר יומן ביקורת של ניהול API ב-Apigee שהקטגוריה שלו תלויה במאפיין type של ההרשאה שנדרשת לביצוע ה-method. ה-methods שבשבילן צריך הרשאה ב-IAM עם הערכים DATA_READ‏, DATA_WRITE או ADMIN_READ במאפיין type יוצרות יומני ביקורת של Data Access. ה-methods שבשבילן צריך הרשאה ב-IAM עם הערכים ADMIN_WRITE במאפיין type יוצרות יומני ביקורת של Admin Activity.

ה-methods של ה-API ברשימה הבאה שמסומנות ב-(LRO) הן פעולות ממושכות. בדרך כלל, ה-methods האלה יוצרות שתי רשומות ביומן הביקורת: אחת כשהפעולה מתחילה ואחת כשהיא מסתיימת. אתם יכולים לקרוא מידע נוסף במאמר בנושא יומני ביקורת של פעולות ממושכות.
סוג ההרשאה Methods
ADMIN_READ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetEntitlement
google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationJob
google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource
google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservationTags
google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs
google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources
ADMIN_WRITE google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations
google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob (LRO)
google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource (LRO)
google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob (LRO)
google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource (LRO)
google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob (LRO)
google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob (LRO)
DATA_READ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetApiObservation
google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetApiOperation
google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservations
google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiOperations

יומני ביקורת של ממשק ה-API

במאמר העזרה בנושא ניהול הזהויות והרשאות הגישה (IAM) לניהול API ב-Apigee מוסבר איך מתבצעת הבדיקה של ההרשאות לכל method ואילו הרשאות נבדקות.

google.cloud.apim.v1alpha.ApiDiscoveryObservation

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.cloud.apim.v1alpha.ApiDiscoveryObservation.

BatchEditTagsApiObservations

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.apiObservations.batchEditTags - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations"

CreateObservationJob

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.observationJobs.create - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob"

CreateObservationSource

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.observationSources.create - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource"

DeleteObservationJob

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.observationJobs.delete - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob"

DeleteObservationSource

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.observationSources.delete - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource"

DisableObservationJob

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.observationJobs.disable - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob"

EnableObservationJob

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • apim.observationJobs.enable - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob"

GetApiObservation

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetApiObservation
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.apiObservations.get - DATA_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetApiObservation"

GetApiOperation

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetApiOperation
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.apiOperations.get - DATA_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetApiOperation"

GetEntitlement

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetEntitlement
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.entitlements.get - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetEntitlement"

GetObservationJob

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationJob
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.observationJobs.get - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationJob"

GetObservationSource

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.observationSources.get - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource"

ListApiObservationTags

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservationTags
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.locations.listApiObservationTags - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservationTags"

ListApiObservations

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservations
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.apiObservations.list - DATA_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservations"

ListApiOperations

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiOperations
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.apiOperations.list - DATA_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiOperations"

ListObservationJobs

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.observationJobs.list - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs"

ListObservationSources

  • Method:‏ google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • apim.observationSources.list - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources"

אילו methods לא יוצרות יומני ביקורת

יכולות להיות כמה סיבות שב-method מסוימת לא נוצרים יומני ביקורת:

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

ה-methods הבאות לא יוצרות יומני ביקורת:

  • google.cloud.location.Locations.GetLocation
  • google.cloud.location.Locations.ListLocations
  • google.longrunning.Operations.CancelOperation
  • google.longrunning.Operations.DeleteOperation
  • google.longrunning.Operations.GetOperation
  • google.longrunning.Operations.ListOperations
  • google.longrunning.Operations.WaitOperation