여러 실행의 로그 검색
Workflow Lineage의 Search logs 탭은 여러 실행의 서비스 로그를 검색합니다. 반복되는 오류를 찾거나 특정 메시지를 조사하고, 워크플로 안의 리소스별 기록을 비교할 때 사용합니다.
검색 범위를 결정하는 두 리소스
실행 시작 리소스(Source executor)는 호출 흐름에서 처음 실행된 리소스입니다. 함수, 액션, 자동화, AIP Logic 함수, AIP Chatbot 또는 모델의 온라인 추론 배포가 될 수 있습니다.
로그 생성 리소스(Producing resource)는 실제로 해당 로그를 남긴 리소스이며, 호출 흐름의 하위 리소스일 수도 있습니다.
단일 실행 시작 리소스 검색
클라우드가 아닌 플랫폼 인스턴스는 단일 실행 시작 리소스 검색을 사용합니다. 선택한 리소스에서 시작한 실행의 로그를 검색하는 방식입니다.
선택한 리소스가 다른 리소스의 호출을 받아 실행되었다면, 그 실행은 선택한 리소스에서 시작한 것이 아니므로 이 검색에 포함되지 않습니다. 호출 흐름을 시작한 리소스로 이동하여 검색해야 합니다.
로그가 없으면 패널은 최근에 선택한 리소스를 호출한 실행 시작 리소스가 있는지 확인하고 제안합니다. 제안을 선택하면 그래프에서 해당 리소스로 이동합니다. 패널 머리글의 Also recently executed by에서도 최근 호출을 시작한 리소스를 확인할 수 있습니다.
전역 로그 검색
전역 로그 검색은 모든 클라우드 플랫폼 인스턴스에서 제공되며, Workflow Lineage 그래프에 있는 지원 리소스를 기준으로 검색 범위를 정합니다.
노드 하나를 선택한 경우
| 선택한 리소스 | 검색 대상 |
|---|---|
| 함수, AIP Logic 함수, 액션, AIP Chatbot, 모델의 온라인 추론 배포, 언어 모델 | 선택한 노드가 로그 생성 리소스인 로그. 다른 리소스에서 시작된 실행도 포함 |
| 자동화 | 선택한 자동화가 실행 시작 리소스인 실행의 로그 |
그 밖의 리소스 유형은 현재 전역 검색에서 지원되지 않습니다.
언어 모델 로그는 함수나 AIP Logic 함수 등 지원되는 실행 시작 리소스에서 모델을 호출한 경우에만 나타납니다. 특정 언어 모델의 노드를 선택하거나 Producing resource 필터에서 Language model을 선택하여 범위를 좁힐 수 있습니다.
지원 노드를 여러 개 선택한 경우
| 범위 | 포함 조건 |
|---|---|
| Across selected resources | 로그 생성 리소스 또는 실행 시작 리소스 중 하나가 선택된 리소스에 해당. 기본값 |
| Within selected call chain | 로그 생성 리소스와 실행 시작 리소스가 모두 선택된 호출 흐름으로 제한 |
Across selected resources에는 현재 그래프에 표시되지 않은 호출 흐름의 로그도 포함될 수 있습니다.
노드를 하나도 선택하지 않으면 그래프에 있는 지원 리소스 전체를 검색합니다.
검색 시작
- Workflow Lineage에서 조사할 워크플로를 엽니다.
- 검색할 리소스 노드를 선택합니다. 전역 검색에서 그래프 전체를 대상으로 삼으려면 선택하지 않습니다.
- 아래 패널의 Search logs 탭을 선택합니다.
- 지원 리소스를 여러 개 선택했다면 범위 메뉴에서 Across selected resources 또는 Within selected call chain을 고릅니다.
검색어와 필터
검색창은 Message와 Content를 포함한 전체 로그 행을 대상으로 검색합니다. 대소문자를 구분하며, *는 임의의 문자열과 일치하는 와일드카드입니다.
| 검색어 예시 | 의미 |
|---|---|
connection failed | 해당 구절이 그대로 들어 있는 로그 |
timeout*retry | timeout 뒤에 임의의 문자열을 거쳐 retry가 나타나는 로그 |
Error | Error는 찾지만 error나 ERROR는 찾지 않음 |
검색 범위에 따라 다음 필터를 사용할 수 있습니다.
| 필터 | 용도 |
|---|---|
| Log level | ERROR, WARN, INFO 등 심각도 선택 |
| Timestamp range | 상대 시간 범위 또는 직접 지정한 시작·종료 시각. 기본값은 최근 하루 |
| Producing resource | 로그를 생성한 리소스 선택 |
| Source executor | 실행을 시작한 리소스 선택 |
| Originating code | 사용자 코드 또는 Foundry가 생성한 로그로 제한 |
필터를 여러 개 적용하면 모두 충족한 로그만 표시됩니다. Reset으로 기본 필터를 복원합니다.
단일 실행 시작 리소스 검색의 날짜 선택 범위는 인스턴스의 로그 보존 기간에 제한되며 날짜 선택기에 표시됩니다. 전역 검색에서 선택할 수 있는 최대 기간은 30일입니다. 실제 결과에는 보존되어 있고 접근 가능한 로그만 나타납니다.
결과 표 읽기
결과는 최신 로그부터 표시됩니다. 검색 모드와 범위에 따라 열 구성이 달라집니다.
| 열 | 내용 |
|---|---|
| Log level | 심각도 아이콘. ERROR·FATAL은 빨강, WARN은 주황, INFO·DEBUG·TRACE는 중립색 |
| Timestamp | 로그가 기록된 날짜와 시각 |
| Message | 주요 메시지 |
| Content | 추가 구조화 데이터. JSON 형식인 경우가 많음 |
| Producing resource 또는 Source executor | 로그 생성 리소스 또는 실행 시작 리소스. 둘 중 하나만 표시 |
| Tags | 로그에 연결된 태그 |
| Parameters | 로그에 연결된 매개변수 |
단일 실행 시작 리소스 검색은 Producing resource를 표시합니다. 그래프 전체나 여러 리소스를 대상으로 한 전역 검색도 이 열을 표시합니다. 전역 검색을 특정 로그 생성 리소스로 좁히면 대신 Source executor를 표시하여 어떤 흐름에서 호출되었는지 알 수 있게 합니다.
검색어와 일치한 텍스트는 Message와 Content에서 강조됩니다.
추가 결과와 최신 로그
| 검색 모드 | 한 번에 불러오는 항목 수 |
|---|---|
| 단일 실행 시작 리소스 검색 | 100 |
| 전역 로그 검색 | 25 |
표 끝까지 스크롤하면 다음 결과를 불러옵니다. 검색은 실시간 스트림이 아니므로 검색을 시작한 뒤 생성된 로그를 보려면 필터를 바꾸거나 화면을 새로 불러와야 합니다.
항목 상세와 실행 추적
Message 또는 Content 셀을 선택하면 전체 항목을 볼 수 있습니다. 상세 화면에는 두 탭, 항목 안에서 텍스트를 찾는 검색창, 긴 줄을 줄바꿈하는 Wrap lines가 있습니다.
결과 행에 마우스를 올리고 View trace를 선택하면 해당 로그를 만든 실행의 추적 화면이 열립니다.
권한과 보존 기간
공유 실행 로그를 검색하려면 실행 시작 리소스의 foundry-telemetry-service:view-execution-history 작업 권한, 로그 접근 활성화, 로그에 지정된 모든 보안 표지의 접근 권한이 필요합니다. 기본 Editor 역할이나 해당 작업 권한을 부여한 사용자 지정 역할을 사용할 수 있습니다.
공유 접근이 활성화되지 않은 일반 인스턴스에서는 필요한 작업 권한을 가진 사용자가 본인의 최근 24시간 실행만 검색할 수 있습니다. 보안 분류 기반 접근 제어(CBAC) 인스턴스에는 이 예외가 없습니다.
보존 기간이 지난 로그는 검색 결과에 나타나지 않습니다. 로그 권한에서 역할과 정책, 표지 조건을 함께 확인합니다.