דיווח על מדדי חיוב

בדף הזה נסביר איך משתמשים ב-Service Infrastructure כדי לאפשר לשירותים מנוהלים לשלוח נתוני שימוש לצורכי חיוב, כדי לחייב את צרכני השירות באמצעות החיוב ב-Cloud. לדוגמה, אתם יכולים להגדיר מדד בשם library.appspot.com/books/borrowed כדי למדוד את מספר הספרים שהושאלו ללקוח, ולהגדיר עבור המדד יחידת אחסון במלאי (SKU) ומחיר.

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

הגדרות לצורכי החיוב

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

  • משאבים במעקב: אתם יכולים לאסוף נתוני חיוב לכל משאב. למשאבים שבמעקב דרוש לפחות מפתח תווית cloud.googleapis.com/location אחד כדי לציין את המיקום של נתוני השימוש לחיוב.

  • מדדים: אתם יכולים לדווח על מדד אחד או יותר. כל אחד מהם משמש למדידת השימוש במשאב מסוג מסוים. לצורכי החיוב נתמכים רק מדדי דלתא (DELTA) עם ערכים מסוג INT64.

  • הגדרות החיוב: מאפשרות לציין את המדדים שיישלחו לחיוב ב-Cloud.

בדוגמה הבאה של ההגדרות לשירות מגדירים מדד אחד שמודד את מספר הספרים שהושאלו ללקוח. הלקוחות יכולים להפעיל את השיטה services.report כדי לדווח על ערכים במדד. לפרטים נוספים על הגדרות החיוב עיינו ב-billing.proto.

# library
monitored_resources:
 - type: library.appspot.com/branch
   labels:
   - key: cloud.googleapis.com/location
     description: The cloud location.
   - key: library.appspot.com/city
     description: The city where the library branch is located in.

# The metrics to be used.
metrics:
- name: library.appspot.com/books/borrowed
  metric_kind: DELTA
  value_type: INT64
  unit: '1'

# The billing configuration.
billing:
  consumer_destinations:
  - monitored_resource: library.appspot.com/branch
    metrics:
    - library.appspot.com/books/borrowed

דיווח על מדדי חיוב

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

$ gcurl -d "{
  'operations': [ {
    'operationId': '8356d3c5-f9b5-4274-b4f9-079a3731e6e5',
    'consumerId': 'project:library-consumer',
    'startTime': '`date +%FT%T%:z`',
    'endTime': '`date +%FT%T%:z`',
    'labels': {
      'cloud.googleapis.com/location': 'us-west1',
      'library.appspot.com/city': 'Kirkland',
    },
    'metricValueSets': [ {
      'metricName': 'library.appspot.com/books/borrowed',
      'metricValues': [ { 'int64Value': '10' } ]
    } ]
  } ]
}" https://servicecontrol.googleapis.com/v1/services/library.appspot.com:report