תיעוד 274
יומני גישה לנתונים
יומני גישה לנתונים של R2 (Data Access Logs) מספקים רשומות ברמת הבקשה עבור פעולות על אובייקטים בתוך דלי (bucket). היומנים זמינים באופן כללי עבור דליי R2 ללא תחום שיפוט.
יומני גישה לנתונים שונים מ-יומני ביקורת, אשר מתעדים שינויי תצורה בדלי. הם שונים גם מ-מדדי R2, אשר מספקים נתוני בקשות ואחסון מצטברים.
הערה
יומני גישה לנתונים כוללים בקשות עם קודי סטטוס HTTP מתחת ל-400, כולל 304 Not Modified. מסירת היומנים היא אסינכרונית ובמתכונת של מאמץ מרבי (best effort), ואירועים עשויים להתעכב או להישמט. בקשות עם קודי סטטוס של 400 ומעלה אינן נכללות. אין להסתמך על יומני גישה לנתונים כתיעוד מלא של הפעילות בדלי.
#ממשקים נתמכים
יומני גישה לנתונים מתעדים בקשות מהממשקים הבאים:
| ממשק | מקור |
|---|---|
S3 | בקשות דרך ה-API התואם ל-S3. |
API | פעולות על אובייקטים מלוח הבקרה או מה-API של Cloudflare. |
Workers | פעולות על אובייקטים דרך קישור (binding) של R2. אירועים אלה כוללים את שם הסקריפט של ה-Worker. |
Public | בקשות לדליים ציבוריים דרך r2.dev או דומיינים מותאמים אישית. בקשות אלו אינן מאומתות. |
#פעולות שנרשמות ביומן
יומני גישה לנתונים מתעדים את הפעולות הבאות:
| קטגוריה | פעולות |
|---|---|
| קריאה | GetObject, HeadObject |
| כתיבה והעתקה | PutObject, CopyObject |
| הצגת רשימה (List) | ListObjectsV1, ListObjectsV2 |
| העלאה מרובת חלקים (Multipart upload) | CreateMultipartUpload, UploadPart, UploadPartCopy, CompleteMultipartUpload, AbortMultipartUpload, ListMultipartUploads, ListParts |
| מחיקה | DeleteObject, DeleteObjects, DeleteObjectsByPrefix |
פעולות על הדלי ופעולות תצורה אינן נכללות. בקשות שנכשלו עם קוד סטטוס HTTP של 400 ומעלה גם כן אינן נכללות.
#הפעלת יומני גישה לנתונים
- בלוח הבקרה של Cloudflare, עבור אל הדלי שברצונך להפעיל. עבור אל הגדרות הדלי ↗
- תחת יומני גישה לנתונים (Data Access Logs), בחר ב-מופעל (Enabled).
R2 מתעד פעולות נתמכות חדשות לאחר הפעלת יומני הגישה לנתונים. פעולות קודמות אינן מתווספות רטרואקטיבית.
ליומני גישה לנתונים יש תקופת שמירה של שבעה ימים. החל מ-1 בדצמבר 2026, הם משתמשים ב-תמחור Cloudflare Observability.
#צפייה ביומני גישה לנתונים
בסעיף יומני גישה לנתונים (Data Access Logs) בהגדרות הדלי, בחר באפשרות הצג יומנים ב-Workers Observability (View logs in Workers Observability). תצוגת ה-אירועים (Events) נפתחת עם מערך הנתונים (dataset) של r2 והדלי הנוכחי שנבחרו עבור השעה הקודמת.
השתמש ב-Query Builder כדי לשנות את טווח הזמן, להוסיף מסננים או לצבור אירועים.
#השבתת יומני גישה לנתונים
- בלוח הבקרה של Cloudflare, עבור אל הדלי שברצונך להשבית. עבור אל הגדרות הדלי ↗
- בתוך יומני גישה לנתונים (Data Access Logs), בחר ב-מושבת (Disabled).
#שדות היומן
כל אירוע יכול לכלול את השדות הבאים:
| שדה | תיאור |
|---|---|
$metadata.timestamp | חותמת זמן של האירוע במילישניות של זמן יוניקס (Unix milliseconds). |
$metadata.service | שם הדלי המשמש כשם השירות. |
$metadata.namespace | מרחב השמות של האירוע. הערך הוא r2. |
action | שם הפעולה ב-R2. |
actor.type | סוג הגורם הפועל: user או service. בקשות לדלי ציבורי משתמשות ב-service. |
actor.id | מזהה של הגורם המאומת. בקשות לדלי ציבורי משתמשות ב-public. |
actor.email | כתובת אימייל עבור גורם מסוג משתמש (user). |
actor.accessKeyId | מזהה מפתח גישה (Access key ID) עבור בקשה שאומתה באמצעות AWS Signature Version 4. |
bucket | שם דלי היעד. |
interface | ממשק הבקשה: S3, API, Workers, או Public. |
request.bytes | ערך ה-Content-Length של הבקשה בבתים. |
response.bytes | ערך ה-Content-Length של התגובה בבתים. |
response.errorCode | קוד שגיאת תגובה. ערך זה הוא NotModified עבור תגובת 304 ו-null עבור תגובת 2xx. |
response.errorMessage | הודעת שגיאת תגובה. ערך זה מתאר תגובת 304 והוא null עבור תגובת 2xx. |
requestMetadata.colo | קוד מרכז הנתונים של Cloudflare, או XXX כאשר מרכז הנתונים אינו זמין. |
אירועים של API תואם S3, של ה-API של Cloudflare ושל דלי ציבורי יכולים לכלול גם את השדות הבאים:
| שדה | תיאור |
|---|---|
request.method | מתודת בקשת HTTP. |
request.uri | נתיב הבקשה. |
response.status | קוד סטטוס של תגובת HTTP. |
requestMetadata.ip | כתובת ה-IP של הלקוח. |
requestMetadata.userAgent | מחרוזת ה-user agent של הלקוח. |
אירועים של קישור Workers (Workers binding) כוללים את השדה הנוסף הבא:
| שדה | תיאור |
|---|---|
scriptName | שם הסקריפט של ה-Worker שהפעיל את הפעולה. |
אירועים של קישור Workers אינם כוללים את מתודת ה-HTTP, הנתיב (URI), סטטוס התגובה, כתובת ה-IP של הלקוח או ה-user agent.
אירוע יכול לכלול את השדות הבאים, הספציפיים לפעולה:
| שדה | תיאור |
|---|---|
resource.key | מפתח האובייקט (Object key). |
resource.type | סוג המשאב: object או multipart_upload. |
resource.size | גודל האובייקט בבתים כאשר הוא זמין. |
resource.uploadId | מזהה העלאה (Upload ID) עבור העלאה מרובת חלקים. |
sourceResource | דלי המקור, המפתח וסוג המשאב עבור פעולת העתקה. |
prefix | קידומת ששימשה בפעולת הצגת רשימה (list) או מחיקה לפי קידומת. |
delimiter | מפריד (delimiter) ששימש בפעולת הצגת רשימה. |
maxKeys | מספר המפתחות המרבי שהתבקש בפעולת הצגת רשימת אובייקטים. |
maxUploads | מספר ההעלאות המרבי שהתבקש בפעולת הצגת רשימת העלאות מרובות חלקים. |
objects | מפתחות אובייקטים שנכללו בפעולת מחיקה מרוכזת (bulk delete). |
השדות request.bytes ו-response.bytes משקפים ערכי Content-Length, ולא מדידות מדויקות של בתים שהועברו. ספירת בתים או גודל משאב של 0 יכולים לציין אפס בתים או שהערך לא היה זמין כאשר R2 יצר את האירוע.