PowerShell 단계에 대한 로깅 구성

PowerShell 단계에서 스크립트에 로그 메시지를 추가합니다. 향상된 로깅 및 디버깅을 위해 로그 수준을 사용합니다.

시작하기 전에

스크립트에 로그 메시지를 추가하려면 Write-SNCLog 함수를 사용해야 합니다. 이 함수는 IH\Logging.psm1 모듈에 정의되어 있습니다. PSScript.ps1을 사용하여 인라인 스크립트가 Write-SNCLog에 액세스할 수 있도록 이 모듈을 가져옵니다. 자세한 내용은 MID Server PowerShell 파일을 참조하세요.

필요한 역할: 관리자

프로시저

1. 다음으로 이동 모두 > MID Server > 속성.
2. true로 설정합니다mid.property.powershell.log_info.
   이 속성은 로깅을 사용하거나 사용하지 않도록 설정합니다. 자세한 내용은 PowerShell 로그 속성을 참조하세요.
3. 원하는 로그 수준으로 설정합니다 mid.property.powershell.ih.log_level .
   로그 수준은 메시지를 기록하는 데 필요한 임계값을 지정합니다. 메시지는 지정된 수준 이상으로 기록됩니다. 예를 들어, 이 특성을 WARN으로 설정하면 WARN 또는 ERROR 레벨의 메시지가 로그됩니다. 레벨이 INFO, DEBUG 또는 TRACE인 메시지는 로그되지 않습니다. 낮은 수준에서 높은 것 순으로 나열된 수준은 다음과 같습니다.

   • 추적
   • 디버그
   • 정보
   • 경고
   • 오류

   기본값은 INFO입니다.
4. 옵션: 인스턴스의 로그를 볼 수 있도록 시스템 속성을 구성합니다.
   1. 다음으로 이동 모두 > 프로세스 자동화 > 플로우 디자이너 > 속성.
   2. 찾기 플로우 로그에 복제할 시스템 로그 항목의 로그 수준을 지정합니다. 시스템은 지정된 수준 이상의 로그 항목만 복제하고 INFO 또는 DEBUG로 설정합니다.

   PowerShell 스크립트를 빌드하고 실행한 후에는 MID 에이전트 로그에서 로그를 사용할 수 있습니다. 이 속성을 구성하면 인스턴스에서 직접 볼 수도 있습니다.

   이 단계에서는 속성을 설정합니다 com.glide.hub.flow_engine.listener_trace.threshold . 플로우 엔진 로그 항목 [sys_flow_log] 테이블에 로그를 복제합니다.

5. PowerShell 스크립트에서 Write-SNCLog 함수를 사용하여 로그 메시지 및 수준을 추가합니다.

   표 1. Write-SNCLog 함수 및 매개 변수

   이름	설명
   Write-SNCLog 함수	PowerShell 단계에 대한 메시지를 기록합니다. Write-SNCLog 에는 두 개의 매개 변수와 -Level-Message. 두 매개 변수 모두 필요하지만 매개 변수 이름은 필요하지 않습니다. 이름을 생략하면 위치가 수준과 메시지를 결정하는 데 사용됩니다. 예시: Write-SNCLog -Level WARN -Message "log warning" Write-SNCLog WARN "로그 경고" 이 두 예제 모두 log WARN: log warning입니다.
   -Level 매개 변수	로그 메시지의 수준을 지정합니다. 유효한 값은 다음과 같습니다. 오류 경고 정보 디버그 추적 이 매개 변수는 필수입니다.
   -Message 매개 변수	기록할 메시지를 지정합니다. 문자열로 입력됩니다. 이 매개 변수는 필수입니다.

6. 작업 또는 플로우를 계속 빌드한 다음, 테스트하고 실행합니다.

다음에 수행할 작업

새 로그는 MID 에이전트 로그에서 사용할 수 있으며 MID Server에서 다운로드할 수 있습니다. 자세한 내용은 MID Server 파일 다운로드를 참조하십시오.

인스턴스에서 로그를 볼 수 있도록 시스템 속성을 설정하면 플로우 엔진 컨텍스트 기록의 플로우 엔진 로그 항목 탭에서 로그를 볼 수 있습니다. 자세한 내용은 플로우 실행 세부 정보를 참조하세요.

관련 태스크

• PowerShell 단계에 대한 자격 증명 테스트