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

시간대가 변경된 datetime 객체입니다.

current_tz str

현재 시간대입니다.

new_tz str

변경할 시간대입니다.

반환

새 시간대가 있는 새 datetime 객체

반환 유형

datetime.datetime

발생 오류

ValueError – 시간대 중 하나가 유효하지 않은 경우

TIPCommon.smp_time.convert_string_to_timestamp

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

날짜/시간 문자열을 타임스탬프로 변환합니다.

매개변수

매개변수
datetime_string str

datetime 문자열입니다.

반환

타임스탬프입니다.

반환 유형

int

TIPCommon.smp_time.datetime_to_rfc3339

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

datetime 객체를 RFC 3999 표현으로 변환합니다.

매개변수

매개변수
datetime_obj datetime.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 전문가로부터 답변을 받으세요.