סקירה כללית

במסמך הזה מפורטת סקירה כללית קצרה על תוויות ועל התכונות שלהן.

מהן תוויות?

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

הדרישות לגבי תוויות

התוויות שמוחלות על משאב צריכות לעמוד בדרישות הבאות:

• אפשר להוסיף עד 64 תוויות לכל משאב.
• כל תווית צריכה להיות צמד מפתח/ערך.
• האורך המינימלי של המפתחות הוא תו אחד, והאורך המקסימלי הוא 63 תווים. המפתחות לא יכולים להיות ריקים. הערכים יכולים להיות ריקים, והאורך המקסימלי שלהם הוא 63 תווים.
• המפתחות והערכים יכולים להכיל רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ומותר להשתמש בתווים בינלאומיים. המפתחות צריכים להתחיל באות קטנה או בתו בינלאומי.
• החלק של המפתח בתווית חייב להיות ייחודי בתוך משאב יחיד. עם זאת, אפשר להשתמש באותו מפתח עם כמה משאבים.

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

שימושים נפוצים בתוויות

ריכזנו כאן כמה תרחישי שימוש נפוצים בתוויות:

• תוויות של צוות או מרכז עלויות: אפשר להוסיף תוויות שמבוססות על צוות או על מרכז עלויות כדי להבחין בין משאבים שנמצאים בבעלות של צוותים שונים (לדוגמה, team:research ו-team:analytics). אפשר להשתמש בסוג הזה של תוויות לצורך הנהלת חשבונות או תקצוב.

• תוויות רכיבים: לדוגמה, component:redis,‏ component:frontend,‏ component:ingest ו-component:dashboard.

• תוויות של סביבה או שלב: לדוגמה, environment:production ו-environment:test.

• תוויות של מדינות: לדוגמה, state:active,‏ state:readytodelete ו-state:archive.

• תוויות בעלות: משמשות לזיהוי הצוותים שאחראים על הפעולות, לדוגמה: team:shopping-cart.

• תוויות רשת: אפשר לצרף תווית למכונה וירטואלית. תגי רשת שהגדרתם בעבר יופיעו כתווית ללא ערך.

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

תוויות ותגים

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

הרשאות

כדי להוסיף, לשנות ולראות תוויות של פרויקטים, נדרשות ההרשאות הבאות:

• אפשר להוסיף או לשנות תווית באמצעות ה-method projects.patch(). לשם כך נדרשת ההרשאה resourcemanager.projects.update.
• כדי לראות את התווית של פרויקט, מפעילים את השיטה projects.get(). לשם כך נדרשת ההרשאה resourcemanager.projects.get.

הסבר על שימוש בתוויות כדי להבין את העלויות

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

ריכזנו כאן כמה דרכים שבהן אפשר להשתמש בתוויות כדי להבין את העלויות:

• אפשר להוסיף תוויות כמו costcenter=cost_center_name, ‏service=service_name ו-environment=environment_name למכונות הווירטואליות או לקטגוריות של Cloud Storage. כך תוכלו להבין איפה המשאבים שלכם פרוסים, מה המטרה שלהם ומהו מרכז העלויות שאליו צריך לחייב אותם.
• אפשר להפעיל ייצוא של נתוני החיוב ל-BigQuery. התוויות מיוצאות ל-BigQuery עם המשאבים המתאימים ונתוני השימוש שלהם. Google Cloud כך תוכלו לעקוב אחרי היבטים כמו העלות של הפעלת שירות עגלת הקניות באפליקציה או העלות של מכונות בדיקה למפתחים.
• אתם יכולים להשתמש ב-BigQuery בשילוב עם תוויות כדי להבין את העלות של כל משאבי מערכת הבדיקה לעומת משאבי הייצור, או כמה עולה שירות מסוים.

דוגמה

בדוגמה הזו, העלות של שירותי playlist בפרויקט נקבעת על ידי ייצוא של נתוני שימוש ותוויות ל-BigQuery. כדי לעשות את זה, קודם צריך להפעיל את ייצוא החיוב ל-BigQuery. ‫labels-demo-prj הוא המקור של נתוני השימוש במשאבים, ו-labels_demo_bqexport הוא קבוצת היעד של הנתונים שבה נשמרים נתוני השימוש. אחרי שמייצאים את נתוני השימוש והתוויות ל-BigQuery, אפשר לדעת מה העלויות של שירות playlist.

כאן מפורטים נתוני השימוש ב-Compute Engine והעלות המשויכת ב-BigQuery.

.