מאמר זה בוחן כיצד אנו יכולים להביא את התיאור המפורט של כל רסיס שמשתתף בתמונת מצב נתונה.
כדי להביא את הסטטוס של תמונת מצב נתונה ב-Elasticsearch, אנו משתמשים בנקודת הקצה Get snapshot status API.
תחביר בקש
תחביר הבקשה הוא כפי שמוצג להלן:
קבל תמונת מצב / _סטָטוּס
קבל תמונת מצב /< מאגר >/ _סטָטוּס
קבל תמונת מצב /< מאגר >/< תמונת מצב >/ _סטָטוּס
הבקשה תומכת בפרמטרי הנתיב הבאים:
- <מאגר> – שם מאגר התמונות. זה מאוד שימושי כדי להגביל את היקף הבקשה למאגר נתון במקום לשאילתה הכוללת את המערכת.
- <תמונת מצב> – מציין את השם של תמונת מטרה. אתה יכול גם לציין את התמונות המרובות כרשימה מופרדת בפסיקים.
אנו יכולים להשמיט את תמונת המצב בפרמטר הבקשה כדי להביא מידע על התמונות הפועלות כעת.
גוף תגובה
הבקשה צריכה להחזיר מידע מפורט על תמונת המצב. מידע כזה הנכלל בתגובה הוא:
- מאגר – שם המאגר שבו נמצאת תמונת המצב.
- תמונת מצב - שם תמונת המצב.
- uuid - UUID של תמונת המצב.
- מדינה – המצב הנוכחי של תמונת המצב. תמונת המצב יכולה להיות במצבים הבאים:
- Include_global_state – מציין אם מצב האשכול הגלובלי כלול בתמונת המצב שצוינה.
- Shard_stats – מציג את ספירת הרסיסים.
- סטטיסטיקות – פרטים על מספר ספירת הקבצים וגודל הקבצים בתמונת המצב.
א. נִכשָׁל – תמונת המצב שהסתיימה עם שגיאה ולא מצליחה לשחזר את הנתונים המגובים.
ב. התחיל – מציין שתמונת המצב פועלת כעת.
ג. חלקי – מראה שמצב האשכול הגלובלי שוחזר אך הנתונים של רסיס אחד לפחות לא הצליחו לאחסן בהצלחה.
ד. הַצלָחָה – מציין שתמונת המצב הסתיימה בהצלחה.
אלו חלק מהמידע שהוחזר מסטטוס תמונת המצב.
Elasticsearch צור תמונת מצב
כדי להמחיש בצורה הטובה ביותר כיצד להשתמש ב-Elasticsearch Get snapshot API, הרשו לנו ליצור תמונת מצב לדוגמה. זכור שסעיף זה אינו מכסה את היסודות של יצירת מאגר Elasticsearch או דרישות אחרות עבור תמונת מצב של Elasticsearch.
עיין בתיעוד למידע נוסף.
נניח שיש לנו מאגר שנקרא elk_bakcups, נוכל ליצור תמונת מצב במאגר הזה עם הבקשה כפי שמוצג בקטע הבא:
סִלְסוּל -XPUT 'http://localhost:9200/_snapshot/elk_backups/test_snapshot?wait_for_completion=true' -ח 'kbn-xsrf: דיווח'הבקשה הקודמת מאתחלת את יצירת תמונת המצב במאגר שצוין.
הערה : הזמן הנדרש להשלמת יצירת תמונת המצב תלוי במספר גורמים.
Elasticsearch קבל סטטוס תמונת מצב
ברגע שאנו מאתחלים את תהליך יצירת תמונת המצב, נוכל לבדוק את מצבו על ידי הפעלת השאילתה הבאה:
סִלְסוּל -XGET 'http://localhost:9200/_snapshot/elk_backups/test_snapshot/_status' -ח 'kbn-xsrf: דיווח'זה אמור להחזיר מידע מפורט על מצב תמונת המצב. פלט לדוגמה הוא כפי שמוצג להלן:
{'תמונות מצב' : [
{
'תמונת מצב' : 'תמונת_בבדיקה' ,
'מאגר' : 'כל_גיבויים' , < חָזָק >
חָזָק > 'uuid' : '9oOJtTunR_WC-1a7NA-9WQ' ,
'מדינה' : 'הַצלָחָה' ,
'include_global_state' : נָכוֹן ,
'סטטיסטיקות_רסיסים' : {
'אתחול' : 0 ,
'התחיל' : 0 ,
'מסיים' : 0 ,
'בוצע' : 94 ,
'נִכשָׁל' : 0 ,
'סך הכל' : 94
} ,
'סטטיסטיקות' : {
'מצטבר' : {
'קובץ_ספירת' : 282 ,
'גודל_ב_בייט' : 750304
} ,
'סך הכל' : {
'קובץ_ספירת' : 692 ,
'גודל_ב_בייט' : 62159894
} ,
'זמן_התחלה_במיליון' : 1663770043239 ,
'זמן_במילי' : 26212
} ,
'מדדים' : { < חָזָק >
חָזָק > 'זרם הנתונים שלי' : {
'סטטיסטיקות_רסיסים' : {
'אתחול' : 0 ,
'התחיל' : 0 ,
'מסיים' : 0 ,
'בוצע' : 1 ,
'נִכשָׁל' : 0 ,
'סך הכל' : 1
} ,
'סטטיסטיקות' : {
'מצטבר' : {
'קובץ_ספירת' : 0 ,
'גודל_ב_בייט' : 0
} ,
'סך הכל' : {
'קובץ_ספירת' : 10 ,
'גודל_ב_בייט' : 13518
} ,
-----------------תְפוּקָה קצוץ --------------------
ב-Kibana, אתה יכול לבדוק את מצב תמונת המצב על ידי ניווט לקטע ניהול מחסנית - תמונת מצב ושחזור.
בחר את תמונת המטרה והצג את הפרטים.
הערה : זכור ש-Kibana אינו מספק פרטים מקיפים כפי שמסופקים על ידי ה-API של Elasticsearch לקבל מצב תמונת מצב.
סיכום
בפוסט זה, חקרנו את היסודות של עבודה עם ממשק ה-API של get snapshot status המאפשר לנו להביא מידע מפורט על תמונת מצב נתונה.
תודה שקראת!