יומנים ומדדים

רישום ביומן

רישום ביומן של Cloud NAT מאפשר לכם לרשום ביומן חיבורי NAT ושגיאות. כשרישום ביומן של Cloud NAT מופעל, יכולה להיווצר רשומה אחת ביומן לכל אחד מהתרחישים הבאים:

• כשנוצר חיבור לרשת באמצעות NAT.
• כשמנות נשמטות כי לא היה פורט זמין ל-NAT.

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

היומנים שנוצרו נשלחים אל Cloud Logging.

מפרטים

המפרטים הבאים חלים על רישום ביומן של Cloud NAT:

• רישום ביומן של Cloud NAT מטפל רק בתנועת TCP ו-UDP.

• רישום ביומן של Cloud NAT מתעד רק מנות שהושמטו אם הן מנות TCP ו-UDP יוצאות (egress). הוא לא מתעד מנות נתונים נכנסות שהושמטו. לדוגמה, אם תגובה נכנסת לבקשה יוצאת נפסלת מסיבה כלשהי, לא מתבצע רישום של שגיאה.

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

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

• רישום ביומן של Cloud NAT לא מתעד כל מנה (packet). גם אם לא הגיעו לסף התעריף של המכונה הווירטואלית, יש תנאים מסוימים שיכולים לגרום להשמטת אירועים מהיומן. כדאי להסתמך על נוכחות של רשומות ביומן של Cloud NAT כדי לקבל החלטות מושכלות, אבל אסור להניח שאם אין רשומות, סימן שהאירוע לא קרה.

הגדרת רישום ביומן

כדי להגדיר רישום ביומן של Cloud NAT, מבצעים את השלבים הבאים.

הפעלת הרישום ביומן

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

אפשר גם לציין את הערכים האלה כשיוצרים או עורכים שער NAT. בהוראות הבאות מוסבר איך להפעיל רישום ביומן עבור שער NAT קיים.

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --enable-logging

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --enable-logging \
    --log-filter=TRANSLATIONS_ONLY

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --enable-logging \
    --log-filter=ERRORS_ONLY

ניקוי המסננים של היומן

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

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --log-filter=ALL

השבתת רישום ביומן

כדי להשבית את הרישום ביומן:

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --no-enable-logging

קביעת סטטוס הרישום ביומן

כדי לקבוע את הסטטוס של הרישום ביומן:

gcloud compute routers nats describe NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION

צפייה ביומנים

כדי לראות את יומני ה-NAT:

resource.type="nat_gateway"
logName="projects/{#project_id}/logs/compute.googleapis.com%2Fnat_flows"

gcloud logging read 'resource.type=nat_gateway' \
    --limit=10 \
    --format=json

מה מתועד ביומן

רשומות ביומן של Cloud NAT מכילות מידע שימושי למעקב ולניפוי באגים בתנועת הנתונים של NAT. הרשומות ביומן מכילות את סוגי המידע הבאים:

• מידע כללי שמוצג ברוב היומנים Cloud de Confiance by S3NS , כמו חומרה, מזהה פרויקט, מספר פרויקט וחותמת זמן.
• מידע ספציפי שקשור ל-Cloud NAT. חלק משדות היומן מכילים רשומות שהן בעצמן כמה שדות. הערכים האלה ותיאורי השדות מופיעים בטבלאות הבאות.

שדות ביומן

הפורמט של השדה NatIpConnection

פורמט השדה NatGateway

הפורמט של השדה InstanceDetails

הפורמט של השדה VpcDetails

פורמט השדה DestinationDetails

הפורמט של השדה GeographicDetails

דוגמאות

דוגמה 1: רשומה של חיבור TCP עם NAT ממכונה וירטואלית ברשת VPC משותפת שיוצאת לשרת חיצוני בצרפת.

{
    insertId: "1the8juf6vab1t"
    jsonPayload: {
        allocation_status: "OK"
        connection: {
            dest_ip : "198.51.100.142"
            dest_port: 80
            nat_ip: "203.0.113.17"
            nat_port: 34889
            protocol: "tcp"
            src_ip: "10.0.0.1"
            src_port: 45047
        }
        destination: {
            geo_location: {
                city: "Bordeaux"
                continent: "Europe"
                country: "France"
                region: "Nouvelle-Aquitaine"
            }
        }
        endpoint: {
            project_id: "service-project-1"
            region: "europe-west1"
            vm_name: "vm-1"
            zone: "europe-west1-b"
        }
        gateway_identifiers: {
            gateway_name: "my-nat-1"
            region: "europe-west1"
            router_name: "my-router-1"
        }
        vpc: {
            project_id: "host-project"
            subnetwork_name: "subnetwork-1"
            vpc_name: "network-1"
        }
    }
    labels: {
        nat.googleapis.com/instance_name: "vm-1"
        nat.googleapis.com/instance_zone: "europe-west1-b"
        nat.googleapis.com/nat_ip: "203.0.113.17"
        nat.googleapis.com/network_name: "network-1"
        nat.googleapis.com/router_name: "my-router-1"
        nat.googleapis.com/subnetwork_name: "subnetwork-1"
    }
    logName: "projects/host-project/logs/compute.googleapis.com%2Fnat_flows"
    receiveTimestamp: "2018-06-28T10:46:08.123456789Z"
    resource: {
        labels: {
            gateway_name: "my-nat-1"
            project_id: "host-project"
            region: "europe-west1-d"
            router_id: "987654321123456"
        }
        type: "nat_gateway"
    }
    timestamp: "2018-06-28T10:46:00.602240572Z"
}

דוגמה 2: הקלטה של מנה שהושמטה כי לא היו יציאות זמינות. המכונה הווירטואלית השולחת ניסתה להגיע לכתובת ה-IP החיצונית של מכונה וירטואלית אחרת באותו פרויקט.

{
    insertId: "1the8juf6vab1l"
    jsonPayload: {
        allocation_status: "DROPPED"
        connection: {
            dest_ip : "192.0.2.87"
            dest_port: 80
            protocol: "tcp"
            src_ip: "10.0.128.1"
            src_port: 45047
        }
        destination: {
            instance: {
                project_id: "service-project-1"
                region: "asia-east1"
                vm_name: "vm-2"
                zone: "asia-east1-b"
            }
        }
        endpoint: {
            project_id: "service-project-1"
            region: "europe-west1"
            vm_name: "vm-1"
            zone: "europe-west1-b"
        }
        gateway_identifiers: {
            cloud_router: "my-router-1"
            gateway_name: "my-nat-2"
            region: "europe-west1"
        }
        vpc: {
            project_id: "host-project"
            subnetwork_name: "subnetwork-1"
            vpc_name: "network-1"
        }
    }
    logName: "projects/host-project/logs/compute.googleapis.com%2Fnat_flows"
    receiveTimestamp: "2018-06-28T10:46:09.123456789Z"
    resource: {
        labels: {
            gateway_name: "my-nat-2"
            project_id: "host-project"
            region: "europe-west1-d"
            router_id: "987654321123456"
        }
        type: "nat_gateway"
    }
    timestamp: "2018-06-28T10:46:01.602240572Z"
}

תמחור של רישום ביומן של Cloud NAT

מידע על תמחור של רישום ביומן

מעקב

‫Cloud NAT חושף מדדים מרכזיים ל-Cloud Monitoring, שמספקים תובנות לגבי השימוש בשערי NAT בצי.

אלה התפקידים שנדרשים בניהול הזהויות והרשאות הגישה (IAM):

• משתמשים ב-VPC משותף עם מכונות וירטואליות ושערי NAT שמוגדרים בפרויקטים שונים? כדי לגשת למדדים ברמת המכונה הווירטואלית, צריך להקצות את תפקיד ה-IAM ‏roles/monitoring.viewer לפרויקט של כל מכונה וירטואלית.

• כדי לגשת למדדים של שער NAT, צריך את תפקיד ה-IAM‏ roles/monitoring.viewer בפרויקט שמכיל את השער.

תדירות הדיווח על מדדים ושמירת הנתונים

המדדים של Cloud NAT נשלחים בקבוצות ומיוצאים ל-Monitoring כל דקה. נתוני המעקב נשמרים למשך שישה שבועות.

כברירת מחדל, לוח הבקרה מספק ניתוח נתונים לשעה האחרונה (1h). אפשר לבקש ניתוח לפרק זמן אחר על ידי בחירה באחד מפרקי הזמן שהוגדרו מראש בתפריט או על ידי הזנה ידנית של פרק הזמן הרצוי. לדוגמה: ‫3h (למשך 3 שעות) או 4d (למשך 4 ימים) או 6w (למשך 6 שבועות).

מדדים של מכונות וירטואליות

למחרוזות של 'סוג המדד' בטבלה הזו צריך להוסיף את הקידומת compute.googleapis.com/. הקידומת הזו הושמטה מהערכים בטבלה.

מאפייני סינון של מכונות וירטואליות

מדדים של NAT Gateway

למחרוזות של 'סוג המדד' בטבלה הזו צריך להוסיף את הקידומת router.googleapis.com/. הקידומת הזו הושמטה מהערכים בטבלה.

מאפיינים של סינון שערים

שליחת שאילתות על מדדים באמצעות Monitoring API

אפשר ליצור שאילתות שרירותיות על מדדי Cloud NAT באמצעות בקשת v3 projects.timeSeries.list של Monitoring API.

דוגמה ל-API

קבלת נתונים על יציאות שהוקצו למכונה וירטואלית, עם צבירה של דקה אחת, פרמטרים של timeSeries.list:

• שם: projects/PROJECT_ID
• מסנן: resource.type = "gce_instance" AND metric.name="compute.googleapis.com/nat/allocated_ports" AND metric.labels.nat_gateway_name="nat-1-237227-1569344091-5"
• interval.start_time: 2019-09-24T16:58:53Z
• interval.end_time: 2019-09-24T16:58:53Z
• aggregation.alignmentPeriod: 60s
• aggregation.crossSeriesReducer: REDUCE_SUM
• aggregation.perSeriesAligner: ALIGN_SUM

"timeSeries": [
    {
        "resource": {
            "labels": {
                "instance_id": "1406292833167995938",
                "project_id": "PROJECT_ID",
                "zone": "us-west1-c"
            },
            "type": "gce_instance"
        },
        "metric": {
            "labels": {
                "nat_ip": "70.32.157.11",
                "nat_gateway_name": "nat-1-237227-1569344091-5",
                "nat_project_number": "PROJECT_NUMBER",
                "router_id": "1380055590921303155"
            },
            "type": "compute.googleapis.com/nat/allocated_ports"
        },
        "metricKind": "GAUGE",
        "points": [
            {
                "interval": {
                    "endTime": "2019-09-24T16:58:53.699Z",
                    "startTime": "2019-09-24T16:58:53.699Z"
                },
                "value": {
                    "int64Value": "64"
                }
            }
        ],
        "valueType": "INT64"
    }
]

תמחור של מעקב אחרי Cloud NAT

המעקב אחרי Cloud NAT לא כרוך בתשלום.

המאמרים הבאים

• סקירה כללית של Cloud Logging
• סקירה כללית של Cloud Monitoring
• פתרון בעיות בהגדרה