מודול smp_time

TIPCommon.smp_time.change_timezone

TIPCommon.smp_time.change_timezone(dtime: datetime, current_tz: str, new_tz: str)→ datetime

משנה את אזור הזמן של אובייקט datetime.datetime.

פרמטרים

פרמטרים
dtime	datetime.datetime אובייקט התאריך והשעה שאזור הזמן שלו משתנה.
current_tz	str אזור הזמן הנוכחי.
new_tz	str אזור הזמן שאליו רוצים לעבור.

מחזירה

אובייקט חדש של תאריך ושעה עם אזור זמן חדש.

סוג הערך שמוחזר

datetime.datetime

העלאות

‫ValueError – אם אחד מאזורי הזמן לא תקין.

TIPCommon.smp_time.convert_string_to_timestamp

TIPCommon.smp_time.convert_string_to_timestamp(datetime_string: str)→ int

הפונקציה ממירה מחרוזת של תאריך ושעה לחותמת זמן.

פרמטרים

פרמטרים
datetime_string	str מחרוזת של תאריך ושעה.

מחזירה

חותמת הזמן.

סוג הערך שמוחזר

int

TIPCommon.smp_time.datetime_to_rfc3339

TIPCommon.smp_time.datetime_to_rfc3339(datetime_obj: datetime)→ str

הפונקציה ממירה אובייקט של תאריך ושעה לייצוג RFC 3999.

פרמטרים

פרמטרים
datetime_obj	datetime.datetime אובייקט התאריך והשעה להמרה.

מחזירה

ייצוג התאריך והשעה בפורמט RFC 3339.

סוג הערך שמוחזר

str

TIPCommon.smp_time.get_last_success_time

TIPCommon.smp_time.get_last_success_time(siemplify, offset_with_metric, time_format=2, print_value=True, microtime=False)

מחזירה את הזמן או התאריך והשעה של ההצלחה האחרונה.

פרמטרים
siemplify	obj מופע של מחלקת ה-SDK‏ SiemplifyConnectorExecution.
offset_with_metric	dict המדד והערך. דוגמה: {'hours': 1}
time_format	int הפורמט של שעת הפלט. דוגמה: DATETIME, UNIX
print_value	אופציונלי bool מציין אם להדפיס את הערך או לא. ברירת המחדל היא True.
microtime	אופציונלי bool מציין אם להחזיר את הזמן בפורמט Unix, כולל מיקרו-זמן. ברירת המחדל היא False.

מחזירה

הזמן שבו הסתיים הסנכרון האחרון.

סוג הערך שמוחזר

Time

TIPCommon.smp_time.get_timestamps

TIPCommon.smp_time.get_timestamps(range_string: str, start_time_string: str, end_time_string: str, error_message: str = None, time_in_milliseconds: bool = False)→ tuple[int, int]

מקבלים חותמות זמן של שעת ההתחלה ושעת הסיום.

פרמטרים

פרמטרים
range_string	str מחרוזת של טווח זמן.
start_time_string	str שעת ההתחלה.
end_time_string	str שעת הסיום.
error_message	str הודעת שגיאה לגבי חריג שהועלה. ברירת המחדל היא None.
time_in_milliseconds	bool הגדרה אם להחזיר את שעת ההתחלה ואת שעת הסיום באלפיות שנייה. ברירת המחדל היא False.

מחזירה

חותמות הזמן של שעת ההתחלה ושעת הסיום.

סוג הערך שמוחזר

tuple

TIPCommon.smp_time.get_timestamps_from_range

TIPCommon.smp_time.get_timestamps_from_range(range_string: str, include_timezone: bool = False)→ tuple[datetime, datetime]

מקבל חותמות זמן של שעת התחלה ושעת סיום מטווח.

פרמטרים

פרמטרים
range_string	str מחרוזת של טווח זמן.
include_timezone	bool, optional הגדרת האפשרות לכלול מידע על אזור זמן בחותמות זמן. ברירת המחדל היא False.

מחזירה

חותמות הזמן של שעת ההתחלה ושעת הסיום.

סוג הערך שמוחזר

tuple

TIPCommon.smp_time.is_approaching_action_timeout

TIPCommon.smp_time.is_approaching_action_timeout(action_execution_deadline_in_unix, timeout_threshold_in_sec=10)

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

לכל סקריפט של פעולה מוגדר מועד סיום ספציפי. הפונקציה הזו בודקת אם הזמן הנוכחי קטן ממועד הסיום לפחות ב-timeout_threshold_in_sec שניות. ברירת המחדל היא 10 שניות, כלומר אם הפעולה קרובה למועד הסיום של הסקריפט שלה (בזמן הבדיקה) ב-10 שניות או פחות, הפונקציה מחזירה True. אם חלף מועד הסיום, הפונקציה מחזירה False.

פרמטרים
action_execution_deadline_in_unix	int תאריך היעד לביצוע הפעולה.
timeout_threshold_in_sec	int סף הזמן הקצוב לתפוגה בשניות.

מחזירה

‫True אם פסק הזמן מתקרב או False בכל מקרה אחר.

TIPCommon.smp_time.is_approaching_timeout

TIPCommon.smp_time.is_approaching_timeout(connector_starting_time, python_process_timeout, timeout_threshold=0.9)

בודקת אם מתקרב פסק זמן.

פרמטרים
connector_starting_time	int השעה שבה המחבר התחיל לפעול.
python_process_timeout	int משך הזמן המקסימלי שהמחבר יכול לפעול.
timeout_threshold	float הסף שבו המחבר נחשב כמתקרב לפסק זמן. ברירת המחדל היא TIMEOUT_THRESHOLD.

מחזירה

True אם מחבר הנתונים מתקרב לזמן קצוב לתפוגה או False בכל מקרה אחר.

TIPCommon.smp_time.save_timestamp

TIPCommon.smp_time.save_timestamp(siemplify, alerts, timestamp_key='timestamp', incrementation_value=0, log_timestamp=True, convert_timestamp_to_micro_time=False, convert_a_string_timestamp_to_unix=False)

שומר את חותמת הזמן האחרונה של התראות נתונות.

פרמטרים
siemplify	obj מופע של מחלקת ה-SDK‏ SiemplifyConnectorExecution.
alerts	dict רשימת ההתראות שבה אפשר למצוא את חותמת הזמן האחרונה.
timestamp_key	אופציונלי str המפתח לקבלת חותמת זמן מההתראה. ברירת המחדל היא timestamp.
incrementation_value	אופציונלי int הערך שבו יוגדל חותמת הזמן האחרונה באלפיות השנייה. ברירת המחדל היא 0.
log_timestamp	אופציונלי bool קובעת אם לרשום ביומן את חותמת הזמן או לא. ברירת המחדל היא True.
convert_timestamp_to_micro_time	אופציונלי bool מציין אם להמיר את חותמת הזמן למיקרו-זמן. ברירת המחדל היא False.
convert_a_string_timestamp_to_unix	אופציונלי bool ההגדרה הזו מציינת אם להמיר חותמת זמן של מחרוזת ל-Unix. ברירת המחדל היא False.

מחזירה

ערך בוליאני שמציין אם חותמת הזמן מתעדכנת.

TIPCommon.smp_time.siemplify_fetch_timestamp

TIPCommon.smp_time.siemplify_fetch_timestamp(siemplify, datetime_format=False, timezone=False)

הפונקציה מאחזרת את חותמת הזמן מ-Siemplify.

פרמטרים
siemplify	obj מופע של מחלקת ה-SDK‏ SiemplifyConnectorExecution.
datetime_format	אופציונלי bool מציין אם להחזיר את חותמת הזמן בפורמט datetime. ברירת המחדל היא False.
timezone	אופציונלי bool מציין אם להחזיר את חותמת הזמן באזור הזמן UTC. ברירת המחדל היא False.

מחזירה

חותמת הזמן.

TIPCommon.smp_time.siemplify_save_timestamp

TIPCommon.smp_time.siemplify_save_timestamp(siemplify, datetime_format=False, timezone=False, new_timestamp=1696256382032)

שמירת חותמת הזמן ב-Siemplify.

פרמטרים
siemplify	obj מופע של מחלקת ה-SDK‏ SiemplifyConnectorExecution.
datetime_format	אופציונלי bool מציין אם לשמור את חותמת הזמן בפורמט datetime. ברירת המחדל היא False.
timezone	אופציונלי bool מציין אם לשמור את חותמת הזמן באזור הזמן UTC. ברירת המחדל היא False.
new_timestamp	אופציונלי int חותמת הזמן החדשה לשמירה.

מחזירה

אין.

TIPCommon.smp_time.validate_timestamp

TIPCommon.smp_time.validate_timestamp(last_run_timestamp, offset_in_hours, offset_is_in_days=False)

בודק את חותמת הזמן בטווח זמן.

פרמטרים
last_run_timestamp	datetime חותמת הזמן של ההפעלה האחרונה.
offset_in_hours	int מגבלת הזמן בשעות.
offset_is_in_days	אופציונלי bool מציין אם ההיסט הוא בימים. ברירת המחדל היא False.

העלאות

‫ValueError – אם חותמת הזמן לא תקינה.

מחזירה

חותמת הזמן שאומתה.

סוג הערך שמוחזר

datetime

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.