OWL 변경 로그¶
이 문서는 OWL CLI(owl), OWL Registry(registry) 및 두 구성 요소가 공유하는 공용 도구 카탈로그의 변경 사항을 기록합니다.
1.9.1(2026/11/20)¶
이번 OWL CLI hotfix는 CLI 자동 업데이트 후 이전 Registry의 도구 인수와 호환되지 않는 문제를 수정합니다.
문제 수정¶
- DQL 자동 사전 검사에서 이전 checker에 정의되지 않은
start_time,end_time을 전달해 쿼리가 차단되는 문제를 수정했습니다. CLI는 먼저 대상 Registry의 checker schema를 읽습니다. checker가 시간 컨텍스트를 지원하지 않으면owl exec는 추가된 자동 시간 검사를 건너뛰고 원래 쿼리와 시간 인수를 유지합니다.owl validate를 명시적으로 실행하면 이전 schema에 따라 기본 DQL 검증을 수행하고 checker 결과를 유지합니다. - CLI의 인수 준비와 정적 검증은 Registry가 게시한 schema를 따릅니다. 생략된 인수에만 schema 기본값을 적용합니다. 시스템 도구와 DPoP 이벤트 하위 호출도 먼저 도구 정의를 확인합니다. 사용자가 지정한 식별 정보, 필터 또는 커서 인수가 지원되지 않으면 오류를 반환해 요청 범위가 바뀌지 않도록 합니다.
- 같은 조직의 워크스페이스 페이지 조회는 schema에 정의된 기본값과 인수 범위를 사용합니다. 응답에 페이지 크기가 없으면 실제 요청 값을 사용합니다. schema가 허용하는 큰 페이지와 서버가 반환한 커서를 사용한 페이지 이동을 지원합니다.
업그레이드 및 호환성 안내¶
- CLI만 업데이트해 이번 인수 호환성 수정을 사용할 수 있습니다. DQL 구문과 기능 지원은 대상 Registry 및 고객 환경에 배포된
dqlcheck에 따라 결정됩니다. checker가 시간 컨텍스트를 지원하면 시간 검사를 계속 수행합니다. schema 조회 또는 checker 실행이 실패하면 계속 오류를 반환합니다. - Registry와 상위 서비스가 비즈니스 규칙을 검사합니다.
owl validate의 정적 검증에 성공해도 비즈니스 요청의 성공을 보장하지는 않습니다.
1.9.0(2026/11/18)¶
신규 기능¶
owl login --dpop및owl logout을 추가했습니다. Studio 임시 인증 코드로 로그인하고 DPoP 자격 증명을 철회할 수 있습니다. CLI는 로컬에서 개인 키를 생성하고 요청에 서명하며, Agent는OWL_TEMP_CODE를 통해 임시 코드를 제공할 수 있습니다.owl profile add <alias>: Studio 임시 코드를 사용하여 DPoP 계정을 추가합니다.--from은 사이트 및 ID와 무관한 설정만 제공합니다. 여러 Profile 사용.- Registry는 DPoP 로그인, 철회 및 도구 요청 전달을 지원하며, 원본 HTTPS URL과 DPoP proof를 바인딩하여 서명한 후 함께 제공되는 AIAPI로 전달합니다. Linux/macOS 및 Windows 설치 프로그램은 CLI가 지원하는 경우 새 로그인 흐름을 사용합니다.
문제 수정 및 최적화¶
- 표준 Registry 이미지를 고정 digest의 Alpine 3.24로 업데이트하고
brotli-libs>=1.2.1-r0을 요구하도록 하여CVE-2026-111497을 수정했습니다. 이 항목은 UOS 이미지에는 해당되지 않습니다. DPoP 요청은 일반 전송 재시도를 사용하지 않으며, 유효한 새 nonce challenge 이후에만 한 번 재시도합니다.
업그레이드 및 호환성 안내¶
- 먼저 대상 사이트의 Studio/AIAPI와 Registry가 DPoP를 지원하는지 확인한 후 공용 설치 채널을 업데이트하세요. 관리자는 AIAPI 서명 대상 및 일관된
siteId를 구성해야 합니다(이미지는OWL_AIAPI_SIGNING_SITE_ID사용). Ingress가 TLS를 종료하는 경우aiapiSigning.dpopTrustedProxies를 구성하고, 경로를 재작성하는 경우dpopUseOriginalURI를 활성화하며 Ingress가 전달 헤더를 덮어쓰도록 해야 합니다. - 기존 API Key Profile은 계속 사용할 수 있습니다.
profile add및profile add --from은 여전히 새 계정의 임시 코드가 필요하며, 원본 파일의 API Key,token_file또는 DPoP 바인딩을 복사하지 않습니다. 기존 스크립트는OWL_TEMP_CODE를 제공하도록 변경해야 합니다. - DPoP 자격 증명은 대상 사이트가 지원하는 HTTP 도구에만 사용할 수 있으며, 외부 MCP 도구 또는 개인 API Key 관리 도구에는 사용할 수 없습니다. DPoP의
workspace use에는 워크스페이스 UUID가 필요합니다. - 동일 설치 환경에서 동일 사이트 및 동일 계정의 여러 별칭은 DPoP 로그인 상태를 공유하므로, 하나에서 로그아웃하면 나머지 별칭도 함께 로그아웃됩니다. 워크스페이스 목록, API Key 가져오기 및 Key에 의존하는 워크스페이스 관리 명령은 여전히 API Key Profile을 사용해야 합니다. 백업 시 개인 키가 포함된
dpop/디렉터리를 안전하게 보관하세요. 여러 Profile 사용.
1.8.0(2026/11/04)¶
신규 기능¶
- Registry는 구성된 Studio/AIAPI 대상에 소스 IP V2 서명을 추가했습니다. HTTP API, 원격 MCP 및 관련 하위 호출은 서명을 공유하며, 전송할 때마다 그리고 전송 계층 재시도 시 nonce와 서명을 다시 생성합니다.
owl.field_schema.search를 추가했습니다. 키워드, 유형, namespace 및 measurement를 기준으로 현재 권한이 있는 워크스페이스 필드 구성을 검색하고 유형, 단위 및 단위 출처를 반환합니다. 페이지네이션을 지원하며 기본 100개, 최대 1000개입니다. 전체 조회용owl.field_schema.get은 유지됩니다. 필드를 알 수 없거나 컨텍스트가 유효하지 않은 경우에만 검색하세요. 빈 결과가 저장소에 데이터가 없음을 의미하지는 않습니다.- 이벤트 offset, 댓글 페이지 번호, 인프라 및 동일 조직 트레이스 커서, 토폴로지 그룹화 파라미터, Monitor/SLO/Member의 선택적 페이지네이션을 보완했습니다. 다음 페이지는 동일한 필터 조건, 시간 범위 및 권한 컨텍스트를 유지합니다. 새 페이지네이션 필드를 생략한 기존 호출은 원래 의미를 유지합니다.
- 노트 수정 및 삭제가
expected_etag를 지원하며, 읽을 때의 버전에 바인딩됩니다. 쓰기 오류에는 완료 단계, 리소스 식별 정보 및 복구 정보가 유지되어 쓰기 실패와 쓰기 후 재읽기 실패를 구분하는 데 도움이 됩니다.
문제 수정 및 최적화¶
- 소스 IP는
X-Forwarded-For의 첫 번째 주소를 우선 사용하며, 전체 헤더가 없거나 공백인 경우에만 연결 피어로 대체합니다. 비어 있지 않은 헤더의 첫 주소가 유효하지 않으면 서명을 거부하고 이후 주소로 대체하지 않습니다. 보호된 대상은 자동 리디렉션을 금지합니다. - CLI, REST 및 MCP는 업스트림의 구조화된 오류, DQL 진단 및 쓰기 복구 정보를 유지합니다. CLI는 파라미터 도움말, 조합 검증 및 클러스터링 쿼리 시간 사전 검사를 개선했습니다. P95 예시를 수정하고 LN, 쿼리 limit, Pipeline 샘플 및 LLM 애플리케이션 범주 계약을 보완했습니다. 클러스터링 처리량은 전체 시간 범위 커버리지를 의미하지 않습니다.
- 외부 MCP는 실패 상태와 여러 텍스트 세그먼트의 순서 및 경계를 유지합니다. 타임아웃, 취소, stdio 프로세스 종료, 파이프 읽기 및 npx 복구를 수정했으며, 단일 메시지 상한은 1 MiB입니다. 출력 및 stderr의 자격 증명 마스킹을 강화했습니다. 도구 위험 주석은 검색 및 캐시를 통해 전달되며, 권한 또는 승인을 대체할 수 없습니다.
업그레이드 및 호환성 안내¶
- 먼저 새 계약을 지원하는 Studio를 배포한 후 Registry를 업그레이드하고 도구 카탈로그를 새로 고치세요. CLI는
owl sync를 실행하고 MCP 클라이언트는 도구를 다시 검색합니다. 도구 카탈로그 동기화는 CLI 바이너리를 업데이트하지 않습니다. 새 버전 도움말, 로컬 검증 및 전체 오류 진단을 사용하려면 CLI를 업그레이드해야 합니다. - Registry 이미지에 포함된 구성은 기본적으로 서명이 활성화되어 있습니다. 관리자는
OWL_AI_API_BASE_URL및OWL_AIAPI_SIGNING_SECRET_BASE64를 구성하고, Studio가 V2를 지원하는지 확인해야 하며, 양쪽은 동일한 32바이트 키의 표준 Base64 값을 사용해야 합니다. 주소 또는 키가 없으면 시작에 실패합니다. 기존 사용자 지정 구성은aiapiSigning을 동기화해야 하며, 생략하면 여전히 비활성화됩니다. stdio를 사용하거나 이 기능을 사용하지 않는 배포에서는aiapiSigning.enabled: false를 명시적으로 설정해야 합니다. - 인그레스 게이트웨이는
X-Forwarded-For를 올바르게 설정하고 정리해야 합니다. Studio/게이트웨이는 보호된 경로의 서명 누락 요청을 독립적으로 거부하고, 화이트리스트, 권한, 시간 범위 및 nonce 중복 제거를 적용합니다. Owl만 업그레이드했다고 해서 전체 보호 경로가 적용된 것은 아닙니다. - 노트 버전 충돌 후에는 다시 읽고 확인해야 하며, ETag를 자동으로 교체하여 재전송하지 않습니다.
expected_etag를 생략하면 읽기 후 쓰기 보호가 제공되지 않습니다. 모니터 업데이트에서 상태, 알림 정책 및 태그를 생략하면 기존 값이 유지되며, 명시적인 빈 목록은 비우기를 의미합니다. 쓰기가 완료되었지만 재읽기가 실패한 경우 중복 생성하지 마세요. 전송 상태를 알 수 없는 경우 먼저 확인하세요.
1.7.0(2026/10/28)¶
신규 기능¶
owl.catalog.entity_create,owl.catalog.entity_modify및 팀 조회owl.workspace.member.group_list를 추가했습니다. 카탈로그 쿼리는 이름, URN 및 속성 필터링을 지원합니다.- CLI에
runtime-profile/v1을 추가했습니다. 실행기가 사용자별로 독립 Profile과 자격 증명을 주입하며, 자격 증명은 구성에 기록되지 않습니다. owl.data.read_dql_docs를 추가했습니다. 검색에서 반환된 도구 참조에 따라 Registry에서 DQL 문서 본문을 페이지 단위로 읽습니다.
문제 수정 및 최적화¶
- DQL 검증은 원본 쿼리, 파싱 또는 바인딩 진단 및 사용 가능한 행/열 정보를 유지하며, 쿼리 오류와 검증기 사용 불가를 구분합니다.
- CLI 명령 로그의 요청 헤더 길이를 제한하여 긴 인라인 파라미터로 인한 전송 실패를 방지했습니다. 비즈니스 파라미터는 여전히 전체 요청 본문을 통해 전송됩니다.
- 인프라 필터링에서 업스트림이 지원하지 않는
like를 제거하고=,!=,in을 지원합니다.
업그레이드 및 호환성 안내¶
- CLI와 Registry를 함께 업그레이드한 후
owl sync를 실행하고, MCP 클라이언트에서 도구를 다시 검색하세요. 카탈로그 쓰기는 함께 제공되는 AIAPI / Backend에 의존하며, 사용 방법은 카탈로그 엔터티 생성 및 수정을 참조하세요. - DQL 문서를 읽을 때는 반환된
read_reference를 사용하고, Agent 로컬에서references_dir를 읽지 마세요. 런타임 Profile 활성화를 위한 연동 순서는 Owl → Agent 전체 릴리스 패키지 → 사용자 모드를 활성화하여 재설치하는 순서입니다. 롤백 전에 사용자 모드를 먼저 비활성화하고 재설치하세요.
1.6.1(2026/10/23)¶
보안 수정¶
- CLI, 표준 및 UOS Registry 빌드 도구 체인을 Go 1.27.3으로 업그레이드하여
crypto/x509의 CVE-2026-111943을 수정하고, 공지에 나열된 신뢰할 수 없는 중간 인증서를 신뢰하지 않도록 했습니다. 소스 빌드에는 Go 1.27.3 이상이 필요합니다.
1.6.0(2026/10/21)¶
신규 기능¶
owl.event.resolve: 이벤트 문서 ID, 이벤트 또는 인시던트 ID, 링크로 이벤트 상세를 조회합니다.owl.account.workspace.same_org.list: 동일 조직 Trace 조회를 위한 후보 워크스페이스를 발견하는 CLI 도구 진입점을 추가했습니다.
문제 수정 및 최적화¶
- CLI, HTTP 및 MCP의 파라미터와 시간 범위 검증을 통일하고, 인프라 필터 조건, 워크스페이스 페이지네이션 및 이벤트 상세 파라미터 검증을 강화했습니다.
owl exec -f json사전 검사가 실패하면 구조화된 JSON과 0이 아닌 종료 코드를 반환합니다. owl sync는 어느 분류든 다운로드가 실패하면 실패를 반환하고, 실패한 분류의 기존 캐시와 로컬 버전을 유지합니다. 최초 자동 동기화가 실패하면 후속 실행이 차단됩니다. 캐시 만료 후 자동 동기화가 실패하면 기존 동작대로 경고하고 기존 캐시를 사용합니다.
업그레이드 및 호환성 안내¶
- CLI와 Registry를 함께 업그레이드한 후
owl sync를 실행하고, MCP 클라이언트에서 도구를 다시 검색하세요.owl.event.get은 계속 목록에서 반환된 원본doc_id를 사용합니다. 이벤트 ID, 인시던트 ID 또는 링크에는owl.event.resolve를 사용하세요. - v1.6.0은 13자리 정수 밀리초 타임스탬프를 통일적으로 검증하며, 종료 시간이 시작 시간보다 커야 합니다. 쌍으로 제공해야 하는 파라미터는 한쪽만 전달할 수 없습니다. 필수 요구 사항과 최대 범위는 각 도구 schema를 기준으로 합니다.
owl.data.query의 시간 범위는 최대 7일입니다. owl.data.query의 DQL은 인라인 시간 창을 생략할 수 있으며,start_time/end_time이 쿼리 창을 제공합니다. 인라인 절대 창은 외부 창과 일치해야 하며, 상대 창은 거부됩니다. PromQL 범위 선택자는 되돌아보기 기간을 의미하고 쿼리 창으로 사용되지 않으며 DQL 검증에도 들어가지 않습니다. Registry에는 사용 가능한dqlcheck가 필요합니다. 검증을 사용할 수 없으면 DQL 쿼리를 실행하지 않습니다. 요청 창은 백엔드의 실제 실행 시간이나 결과가 커버하는 시간 범위와 동일하지 않습니다.
1.5.0(2026/10/14)¶
OWL CLI 신규 기능¶
- CLI에 독립 Profile 관리 및 계정 전환 기능을 추가했습니다.
owl profile add/list/current/rename/remove를 통해 여러 개의 전체 구성을 저장하고 관리할 수 있으며,owl switch,--profile또는OWL_PROFILE을 통해 구성을 영구적으로 또는 임시로 선택할 수 있습니다. 각 명명된 Profile은 구성, 자격 증명, 캐시, 데이터 및 로그를 독립적으로 저장합니다. (#21) - CLI에 Bash 및 PowerShell 오프라인 자동 완성을 추가했습니다. 명령, Profile 별칭, 분류, 도구 이름, 도구 파라미터 및 schema 열거 값을 제안할 수 있습니다. 자동 완성은 현재 Profile의 로컬 캐시만 읽으며, 네트워크에 연결하지 않고 도구도 실행하지 않습니다. (#24)
OWL CLI 문제 수정 및 최적화¶
- Bash 자동 완성 후보 매칭을 강화하여 schema의 셸 특수 문자, 공백 또는 URL을 모두 리터럴 값으로 처리합니다. (#24)
owl profile remove --purge정리 실패 시 구성과 자격 증명이 먼저 제거될 수 있는 문제를 수정했습니다. 실패 후 권한을 수정하고 다시 시도할 수 있습니다. (#21)
OWL Registry 및 공용 도구 카탈로그¶
owl.external_datasource.list및owl.external_datasource.query를 추가했습니다. 현재 워크스페이스에서 접근 가능한 외부 데이터 소스를 발견하고, 목록에서 반환된datasource_uuid를 사용하여 단일 제한 읽기 전용 SQL을 실행하는 데 사용합니다. (#13)- Registry 로그는
sql,rows및 중첩된arguments등 민감한 필드를 완전히 마스킹합니다. (#13) owl.metric.list,owl.rum.list,owl.apm.list,owl.network.list,owl.profile.list,owl.logging.list,owl.billing.list및owl.infrastructure.list/get는 이제 13자리 밀리초 단위start_time과end_time을 전달해야 하며, 시간 창은 최대 7일입니다. (#25)owl.llm.list의 시간 범위는 여전히 선택 사항입니다.start_time과end_time을 모두 생략하면 최근 24시간을 조회합니다. (#25)- DQL 쿼리 도구의
dql_namespace/namespaceschema에 전체 열거 및 일반 데이터 유형 매핑을 보완했습니다.owl.data.show_dql_namespace는 전체 유형 의미를 제공하며, 반환된dql_namespace값이owl.data.query에서는 동일한 이름의 필드를 계속 사용하고 simple query 및 로그 클러스터링 도구에서는namespace에 그대로 전달해야 함을 명확히 합니다. 기존 필드 이름과 요청 전달 동작은 변경되지 않습니다.
업그레이드 및 호환성 안내¶
- Profile을 선택하지 않은 경우 기존
${OWL_DIR}/config.yaml을 계속 사용합니다. 루트 구성은default로 유지되며 자동으로 이전되지 않습니다. CLI의--conf는 더 이상 사용되지 않으며, 구성을 가져온 후--profile로 전환할 것을 권장합니다. Registry 서비스의--config는 영향을 받지 않습니다. (#21) - Registry 또는 공용 카탈로그를 업그레이드한 후
owl sync를 실행하세요. 위의 discovery 및 infrastructure 도구를 호출할 때는 시간 범위를 명시적으로 전달해야 합니다.owl.llm.list는 계속 시간 범위를 생략할 수 있습니다. (#25)
1.4.0(2026/09/23)¶
신규 기능¶
- 권한이 부여된 크로스 워크스페이스 데이터 쿼리를 추가했습니다.
owl.workspace.data_authorized.list를 통해 권한이 부여된 워크스페이스를 발견한 다음, DQL 도구에workspace_uuids와target_region을 전달합니다. 현재 워크스페이스 쿼리에는 워크스페이스 발견이 필요하지 않으며, 동일 조직의 크로스 워크스페이스 Trace는 계속 독립 도구를 사용합니다. workspace분류를 추가했습니다. 권한이 부여된 워크스페이스 목록과owl.workspace.member.list를 포함합니다. 이전 이름인owl.member.list는 호출 별칭으로 유지되며, CLI와 MCP 모두 새 도구의 파라미터 및 권한 검증을 재사용합니다.owl.incident.get을 추가했습니다. 인시던트 UUID로 상세 및 페이지네이션된 관련 이벤트 참조를 가져온 다음,owl.event.get을 통해 이벤트 내용을 읽습니다.
문제 수정 및 최적화¶
- 이전
testing-<SHA>빌드가owl update로 업그레이드되지 않는 문제를 수정했습니다. Linux/macOS 및 Windows 설치 프로그램 모두 현재 구성된 채널의 정식 버전으로 마이그레이션할 수 있으며, 기존 구성 및 SHA256 검증을 유지합니다. 일반 버전은 계속 업그레이드만 허용하고 다운그레이드는 하지 않으며, 동일 버전은 설치를 건너뛰고, 인식할 수 없는 버전은 계속 오류를 보고합니다. (#226) - CLI와 MCP는 AIAPI 오류 진단 필드 및 trace ID를 유지하여 크로스 워크스페이스 쿼리 실패 원인을 더 쉽게 파악할 수 있습니다.
- 파라미터 사전 검사가 JSON Schema 유니온 유형을 지원하며, 각 유형 분기의 제약 검증을 유지합니다.
- 정적 MCP 도구에 OpenAI 메타데이터를 보완하고, OAuth Bearer token이 업스트림으로 전달되는 문제를 수정했습니다.
업그레이드 요구 사항¶
- 먼저 대상 사이트에 함께 제공되는 AIAPI가 배포되었는지 확인하세요. 여기에는
/api/v1/workspace/data_authorized/list, 크로스 워크스페이스 쿼리 계약 및/api/v1/incident/get이 포함됩니다. - CLI와 Registry 프로그램을 함께 업그레이드한 다음
owl sync를 실행하여 카탈로그를 전체 새로 고침하세요. MCP 클라이언트에서 도구를 다시 검색합니다. 이전 버전 CLI는 별칭을 지원하지 않으므로, 카탈로그만 동기화해도 기존 명령을 사용할 수 있다고 보장할 수 없습니다. - 이전
member분류는 제거되었습니다. 권한이 부여된 워크스페이스 발견은owl.workspace.data_authorized.list로 통일합니다. 자세한 내용은 마이그레이션 안내를 참조하세요.
1.3.0(2026/08/26)¶
이번 릴리스는 기능 개선 릴리스로, 주요 업데이트는 다음과 같습니다.
신규 기능¶
- CLI에 전역
--conf파라미터를 추가하여 구성 파일을 명시적으로 선택할 수 있습니다. 구성 표시 및 쓰기는 선택한 파일을 따릅니다. - CLI에
registry.insecure_skip_verify및registry.request_timeout구성을 추가했습니다. 통제된 개발 환경 및 오래 걸리는 데이터 쿼리에 사용됩니다. TLS 검증 건너뛰기는 기본적으로 비활성화되어 있으며, 요청 타임아웃 기본값은 150초입니다. - Registry에 통합 OAuth Broker의 사이트 라우팅 및 token issuer/audience 검증을 추가했습니다. 대상 AI API는 서버 측 화이트리스트에 의해 결정됩니다.
- Center MCP는 구성에 따라 정적 도구를 직접 노출하고 지정된 도구를 제외할 수 있습니다. 기본적으로는 여전히 기존 facade 도구를 사용합니다.
- Registry에 OpenAI Apps challenge endpoint를 추가했습니다. token이 구성되지 않은 경우 비활성 상태를 유지하고 404를 반환합니다.
- Registry 로컬 배포 보조 흐름을 추가하여 원격 AI API 및 S3 서비스를 구성할 수 있습니다.
문제 수정/최적화¶
- OAuth 업스트림의 미인가 응답을 유지하여 호출자가 자격 증명 문제를 올바르게 식별할 수 있도록 했습니다.
owl.data.simple_query_file의limit은 이제 실행 전에 1에서 10000 사이인지 검증합니다.- 데이터 쿼리 도구 타임아웃을 130초로 조정하고, Registry 클라이언트 기본 타임아웃을 150초로 조정하며 구성할 수 있도록 지원했습니다.
- Registry 이미지에 버전 및 revision 정보를 기록하고 릴리스 흐름 회귀 테스트를 보완하여 빌드 산출물의 추적성을 향상했습니다.
호환성 조정¶
- 기존 CLI 명령 및 기본 구성 경로는 변경되지 않습니다.
--conf는 새 진입점이며, TLS 검증 건너뛰기는 기본적으로 비활성화되어 있습니다. - MCP는 기본적으로 여전히 facade 도구를 노출합니다. 사이트 라우팅 및 OpenAI Apps challenge는 모두 명시적으로 구성한 후에 활성화됩니다.
- 아직 완전히 설계되지 않은 Agent Protocol(
owl agent --stdio포함)은 이번 릴리스에 포함되지 않습니다.
1.2.1(2026/08/07)¶
이번 릴리스는 hotfix 수정에 해당하며 내용은 다음과 같습니다.
문제 수정¶
- data 유형 도구가 생성하는 결과 파일 ID가 너무 긴 문제를 수정했습니다. 새 파일은 22자리 URL-safe 임의 ID를 사용하므로 긴 파라미터로 인해 파일 이름과 경로가 길어지는 위험을 줄이고, Agent가 후속 명령에서 참조하기도 더 쉽습니다. (#8)
owl.data.simple_query및owl.data.simple_query_file이 파라미터 schema만 검증하고 자동 생성된 DQL은 검증하지 않는 문제를 수정했습니다. 이제 실행 전에 동등한 DQL을 구성하고 Registry의 DQL 검증 기능을 호출하여 유효하지 않은 쿼리 조각을 사전에 차단합니다. (#7)
기능 최적화¶
- simple query의 생성된 DQL 검증이 실패하면 구조화된
generated_dql/dql.builderError문제를 반환하여 Agent가where_clause,select_clause,group_by_clause등 파라미터를 파악하고 수정하기 쉽게 했습니다. (#7)
호환성 조정¶
- data 파일 인덱스 형식과 안정적인
queryKey는 변경되지 않으며, 기존 인덱스 및 결과 파일은 계속 읽을 수 있습니다. 새로 생성되는 파일의 ID와 파일 이름만 짧아집니다. (#8) - 유효한 simple query 호출 방식과 원격 실행 경로는 변경되지 않습니다. 유효하지 않은 DQL만 요청이 전송되기 전에 더 일찍 실패합니다. (#7)
1.2.0(2026/08/05)¶
이번 릴리스는 기능 개선 릴리스로, 주요 업데이트는 다음과 같습니다.
신규 기능¶
- CLI에
owl validate,owl tool validate및owl capabilities를 추가했습니다. 대상 도구를 실행하지 않고 파라미터 schema와 도구 전용 구문을 검증하며, 구조화된 결과를 통해 Agent가 판단하고 수정할 수 있습니다. (#6) - 계정 워크스페이스 및 로컬 profile 관리 기능을 추가했습니다. 워크스페이스 목록, 액세스 키 가져오기, 워크스페이스 전환 및 현재 컨텍스트 조회를 포함합니다. profile은 워크스페이스 자격 증명과 현재 컨텍스트를 관리하는 데 사용되며, 캐시와 data 파일은 계속 구성된 공유 경로를 사용합니다. (
3da3e8e) - 동일 조직 워크스페이스 발견을 추가하고, 데이터 쿼리에서
same_org_workspace_uuids를 통해 동일 조직의 여러 워크스페이스를 조회할 수 있도록 했습니다. 크로스 워크스페이스 Trace 검색에 사용할 수 있습니다. (71fa73e) owl exec에 버전 업데이트 알림을 추가했습니다. CLI는 업데이트 채널에 따라 새 버전을 스로틀링하여 확인하고, JSON 출력에서 기존 파싱에 영향을 주지 않는notice필드로 업그레이드를 알립니다. (7c7113c)- 공용 도구 카탈로그에 mdsearch 문서 검색 및 SLO 목록 기능을 추가했습니다. (
135c8ff,18f87b0) - 공용 도구 카탈로그에 Studio Notes V2 노트 목록, 추가, 수정 및 삭제 기능을 추가했습니다. (
a72af5f) - 공용 도구 카탈로그에 데이터 전송 규칙 발견 및 비동기 쿼리 기능을 추가했습니다. (
6c37c93,c6dcd80) - 공용 도구 카탈로그에 Dashboard 목록 기능을 추가했습니다. (
6c98f0b) - Linux, macOS, Windows 5개 플랫폼을 대상으로 하는 OSS 자동 릴리스 파이프라인을 추가했습니다. 테스트 채널 검증을 통과하면 동일한 빌드 산출물을 프로덕션 채널로 승격할 수 있습니다. (
9fba8e2)
문제 수정¶
- HTTP 도구 업스트림이 클라이언트 오류를 반환할 때 Registry가 원본 상태와 오류 정보를 잃는 문제를 수정했습니다. 이제 CLI에서 더 정확하고 실행 가능한 실패 원인을 확인할 수 있습니다. (
e1267e0) - Dashboard의 큰 결과가 여전히 text 경로로 반환되는 문제를 수정했습니다. 관련 도구는 이제 data 파일에 결과를 저장하여 큰 페이로드가 Agent 컨텍스트를 차지하는 것을 방지합니다. (
68cac16) - 데이터 전송 쿼리 결과가 여전히 text 경로로 반환되는 문제를 수정했습니다. 이제 쿼리 결과는 data 파일에 기록됩니다. (
30aa6fc) - 워크스페이스 자격 증명 전환 및 표시 과정에서 계정 정보가 혼동될 수 있는 문제를 수정했습니다. 구성 출력은 기본적으로 키를 숨기며, 명시적으로 요청한 경우에만 원본 secret을 표시합니다. (
3da3e8e) - Streamable MCP 세션은 이제 설정 전에 인증을 완료하며, 미인가 요청은 세션 상태를 생성하지 않습니다. (
2a5d8e9)
기능 최적화¶
owl exec와owl validate의 파라미터 파싱 및 사전 검사 로직을 통일하여 한 번에 모든 파라미터 문제를 반환할 수 있도록 했습니다. 검증 전에 정상적인 최초 사용 또는 캐시 만료 자동 동기화를 수행하며, 여전히tool_not_found가 반환되면owl sync를 명시적으로 실행한 후 다시 시도해야 합니다. (#6)- CLI 작업에는 안정적인 operation ID가 포함되며, Registry 요청과 업스트림 실패 사이에서 추적 정보를 전달하여 계층 간 문제를 더 쉽게 파악할 수 있습니다. (
386abc0) - 로그의 민감한 token은 문제 연관에 사용할 수 있는 처음과 끝 문자만 유지하고 중간 내용은 마스킹하여 전체 자격 증명이 로그에 남지 않도록 했습니다. (
6a6d0ad)
호환성 조정¶
list,show,exec,schema등 기존 짧은 명령 및tool/tools네임스페이스는 계속 호환됩니다.validate와capabilities는 새 진입점입니다. (#6)- 이전 버전의
token,auth.token,workspaces.<name>.token및auth.token_file구성은 계속 읽을 수 있습니다. 새로 기록되는 자격 증명은 일괄적으로api-key를 사용하며, 기존 구성을 자동으로 삭제하지 않습니다. (3da3e8e) owl.data.query의 PromQL 모드는 DQL 검증기로 들어가지 않습니다. 기존 유효한 쿼리와 MCP 도구 호출 방식은 변경되지 않습니다. (#6)
1.0.11(2026/05/25)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
data분류에 CLI 전용 도구owl.data.simple_query_file을 추가했습니다. CLI가 최신 공용 도구 카탈로그를 동기화한 후 simple query 파라미터로 기존 simple query 백엔드 인터페이스를 호출하고, 기존 data 파일 수명 주기를 통해 결과를 저장할 수 있습니다.owl.data.simple_query_file과 MCP 도구owl.data.simple_query는 독립적인 노출 범위를 유지하여 큰 결과가 MCP text/context 경로로 반환되는 것을 방지합니다.
기능 최적화¶
- 실제 public config 회귀 테스트를 보완하여
owl.data.simple_query_file의 CLI 가시성, MCP 비가시성,outputType: data, 인증 방식 및 파라미터 schema를 커버했습니다.
호환성 조정¶
- 기존 MCP 도구
owl.data.simple_query는outputType: text및 MCP 전용 노출 방식을 그대로 유지합니다.
1.0.10(2026/05/18)¶
이번 릴리스는 hotfix 수정에 해당하며 내용은 다음과 같습니다.
문제 수정¶
registry.endpoint가 후행 슬래시가 있는 주소로 구성된 경우 CLI가 Registry API 경로를 이어 붙일 때 이중 슬래시가 생성되어owl sync가 nginx 404를 반환할 수 있는 문제를 수정했습니다.- Registry Client는 이제 생성 시 endpoint를 정규화하므로
http://testing-owl-api.dataflux.cn/와http://testing-owl-api.dataflux.cn을 동일한 Registry 주소로 처리할 수 있습니다.
기능 최적화¶
- Registry Client 및
SyncAll회귀 테스트를 보완하여 후행 슬래시가 있는 endpoint에서의 분류 동기화 경로를 커버하고, 이후 URL 이어 붙이기 회귀를 방지했습니다.
호환성 조정¶
- 사용자 구성 형식은 변경되지 않습니다. 후행 슬래시가 없는 기존 endpoint는 원래 동작을 유지하며, 후행 슬래시가 있는 endpoint도 호환됩니다.
1.0.9(2026/05/12)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
data분류에owl.logging.cluster_task.create를 추가했습니다. CLI가 최신 공용 도구 카탈로그를 동기화한 후 비동기 로그 클러스터링 분석 작업을 생성할 수 있습니다.data분류에owl.logging.cluster_task.get을 추가했습니다. create에서 반환된task_id로 비동기 로그 클러스터링 분석 결과를 조회할 수 있습니다.- 로그 클러스터링 작업은 전체
query를 전달하는 방식과namespace,conditions,timeRange,analysisField및indexes를 통해 백엔드가 쿼리를 구성하도록 하는 방식을 모두 지원합니다.
기능 최적화¶
data분류 설명과 버전을 업데이트하여 공용 카탈로그에 로그 클러스터링 작업 생성 및 조회 기능이 포함되었음을 명확히 했습니다.- loader 및 Registry server 회귀 테스트를 보완하여 로그 클러스터링 작업 schema 파싱, 필수 파라미터 검증 및 REST 실행 전달을 커버했습니다.
호환성 조정¶
- 이번 변경은 도구 추가이며, 기존
owl.logging.list,owl.data.query또는 기타 data 분류 도구의 호출 방식은 변경되지 않습니다.
1.0.8(2026/05/07)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
data분류 검색 경로에owl.logging.list및owl.billing.list를 보완했습니다. CLI가 최신 공용 도구 카탈로그를 동기화한 후 로그 및 클라우드 청구의 source / field를 직접 발견할 수 있습니다.owl.metric.list는mode=tag를 지원하여 메트릭 tag key를 발견하고,source를 통해 필드 또는 tag 결과를 필터링할 수 있습니다.- data 결과 파일 이름은 읽기 쉬운 접두사를 유지하고 UUID를 추가하여 중복 쿼리 또는 다중 session 동시 실행 시 같은 이름의 파일을 덮어쓰는 것을 방지합니다.
- data 파일 인덱스에 안정적인
queryKey를 추가하여 동일 쿼리를 식별하는 데 사용하고, 이전 버전index.json과의 호환성을 유지합니다.
문제 수정¶
- 검색 도구 schema가
source파라미터를 선언하지 않아owl exec ... --source ...가 로컬 파라미터 검증에서 거부되는 문제를 수정했습니다. - AIAPI discovery list가
success:false비즈니스 오류를 반환할 때 Registry REST 및 MCP HTTP 도구 외부 계층이 여전히 성공으로 잘못 보고할 수 있는 문제를 수정했습니다. - 설치 프로그램의
--owl-dir/-OwlDir로 사용자 지정 Owl 디렉터리를 지정한 후 이후owl config show를 직접 실행하면 여전히 기본 구성 디렉터리로 대체될 수 있는 문제를 수정했습니다.
기능 최적화¶
- README 및 사용 문서의 데이터 검색 예시를 업데이트하여
mode=field,mode=tag,owl.logging.list및owl.billing.list의 호출 방식을 보완했습니다. - 공용 카탈로그 동기화 알림을 조정하여 공용 카탈로그가 매칭될 때 오해하기 쉬운
Scope: public catalog가 출력되지 않도록 했습니다. owl data clean은 기본적으로 1일 이전 파일을 정리하며,--days 0또는 음수는 1일로 처리합니다.owl data clean은 index에 등록된 만료 파일만 정리하며, 등록되지 않은 고아 파일은 기존 동작대로 능동적으로 스캔 및 삭제하지 않습니다.- Linux/macOS 및 Windows 설치 프로그램은 설치 대상 옆에
.owldir경로를 기록하고, 사용자 지정 디렉터리를 사용하지 않거나 제거할 때 이전 기록을 정리하여 CLI가OWL_DIR환경 변수가 없어도 사용자 지정 구성, 캐시 및 데이터 디렉터리를 계속 찾을 수 있도록 합니다. - loader, executor, Registry REST, MCP의 discovery schema 및 비즈니스 오류 회귀 테스트를 추가했습니다.
- CLI 구성 파싱 및 설치 프로그램 사용자 지정 디렉터리 회귀 테스트를 보완하여
.owldir기록 읽기,config show경로 표시 및 설치 후 디렉터리 위치를 커버했습니다.
호환성 조정¶
owl exec파라미터 형식은 변경되지 않으며,--key value,key=value,-pJSON 및--stdin을 계속 지원합니다.- 비메트릭 discovery 도구는
mode=source|field만 허용합니다.mode=tag는owl.metric.list에만 적용됩니다.
1.0.7(2026/04/29)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
- CLI에
tool네임스페이스를 추가하고tools별칭을 유지했습니다. 이 진입점은list,show,exec,schema등 최상위 명령 외의 보조 형식으로, Agent가 명령 형식을 추측할 때의 내결함성을 높입니다. category에categories별칭을 추가하여 Agent가 자연스러운 명령 추측 방식으로 분류 기능을 발견할 수 있도록 했습니다.
문제 수정¶
owl help tool,owl help categories등 도움말 주제를 해석할 수 없는 문제를 수정했습니다.- 일부
--help호출이 구성 초기화 또는 Registry 의존성을 조기에 트리거하는 문제를 수정하여, 이제 도움말 명령이 구성되지 않은 환경에서도 바로 반환될 수 있습니다.
기능 최적화¶
- 도움말 주제 회귀 테스트를 보완하여 주제별 도움말 조회(예:
owl help tool)와 명령별 도움말 보기(예:owl tool --help)가 일관된 정보를 반환하는지 확인했습니다. - README의 도구 조회 명령 예시를 조정하여
tool네임스페이스 사용법을 보완했습니다.
호환성 조정¶
list,show,exec,schema등 기존 최상위 명령은 여전히 주요 사용 방식이며 계속 호환되어 기존 스크립트를 깨뜨리지 않습니다.- 더 이상 게시되지 않는 일부 예시 도구 및 Skill 구성을 정리했습니다.
1.0.6(2026/04/28)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
owl update명령을 추가했습니다. 설치 프로그램이 기록한 업데이트 채널에 따라 해당 플랫폼의 설치 스크립트를 다운로드하고 실행할 수 있습니다.- Linux/macOS 설치 스크립트에
--upgrade를, Windows 설치 스크립트에-Upgrade를 추가하여 원격 버전이 업데이트된 경우에만 로컬 CLI를 업그레이드하도록 했습니다. - 설치 프로그램은 구성에
update.base_url및update.channel을 기록하여 이후owl update에 업데이트 소스를 제공합니다.
문제 수정¶
- 업그레이드 시 기존 설치 경로를 안정적으로 찾지 못하는 문제를 수정했습니다. 업그레이드 흐름은 Owl 디렉터리의
binpath를 우선 읽고, 없으면PATH의owl로 대체합니다. - 로컬 버전이 원격 버전보다 낮지 않은 경우에도 덮어쓰기 설치될 수 있는 문제를 수정했습니다. 이제 바이너리 교체를 건너뛰고 업데이트 채널 구성만 새로 고칩니다.
기능 최적화¶
- 설치 프로그램에 시맨틱 버전 비교 로직을 추가하여 업그레이드 전에 로컬
owl --version과 원격 channelversion을 읽어 비교합니다. - 업데이트 흐름은 Linux/macOS에서는 설치 스크립트를 동기적으로 실행하고, Windows에서는 독립 PowerShell 프로세스로 설치 프로그램을 시작하여 실행 중인 바이너리 교체 위험을 줄입니다.
1.0.5(2026/04/28)¶
이번 릴리스는 hotfix 수정에 해당하며 내용은 다음과 같습니다.
문제 수정¶
- Linux/macOS 설치 프로그램이 macOS 기본 제공 Bash 3.2에서 체크섬 비교를 실행할 때
bad substitution을 보고하는 문제를 수정했습니다. - Bash 4 구문
${var,,}을 POSIX 도구 체인에서 사용 가능한tr '[:upper:]' '[:lower:]'로 교체하여 체크섬 대소문자 정규화 로직이 이전 Bash와 호환되도록 했습니다.
기능 최적화¶
- 5개 플랫폼 CLI 패키지를 다시 빌드하여 릴리스 디렉터리 버전, manifest 버전 및 패키지 내
owl --version출력이 일치하도록 했습니다. skill.md및skill.en.md두 Skill 문서를 유지하여 중국어 및 영어 Agent Skill 배포를 계속 지원합니다.
1.0.4(2026/04/27)¶
이번 릴리스는 installer channel 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
skill.en.md를 릴리스하여 영어 Agent Skill 설명 파일을 보완했습니다.- 임시 코드 설치 및 사용자 지정 Owl 디렉터리를 지원하는 설치 프로그램 지원 파일을
1.0.4channel 디렉터리에 릴리스했습니다.
문제 수정¶
- 이전 버전 프로덕션 channel 설치 스크립트에
OWL_DIR/OwlDir지원이 누락된 문제를 수정했습니다. - 기존
1.0.3channel이 동기화 캐시의 영향을 받을 때 동일 버전 릴리스를 직접 덮어쓰는 것을 피하고, 새 channel 디렉터리에 수정된 설치 진입점을 두도록 변경했습니다.
1.0.3(2026/04/27)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
- 설치 프로그램에
OWL_TEMP_CODE지원을 추가하여OWL_REGISTRY_ENDPOINT를 기반으로ai-api주소를 추론하고,/api/v1/account/accesskey/exchange를 통해 실제 token으로 교환할 수 있습니다. skill.md를 추가하여 Agent 통합 시나리오에 channel과 함께 배포되는 Skill 설명을 제공합니다.
문제 수정¶
bash -c "$(curl .../install.sh)"진입점에서BASH_SOURCE[0]을 읽지 못할 수 있는 문제를 수정하여$0fallback이 있는 스크립트 진입점 해석으로 변경했습니다.- 인라인 installer helper에 예기치 않은 줄바꿈 표기가 나타나는 문제를 수정하여 릴리스 버전
install.sh가 직접 실행 가능한 자체 포함 스크립트에 더 가깝도록 했습니다.
기능 최적화¶
- 임시 코드로 token을 교환할 때
OWL_TOKEN과 교환 결과가 일치하는지 검증하며, 일치하지 않으면 설치를 즉시 중단합니다. OWL_TEMP_CODE요청은 기본적으로 로컬 프록시를 우회하여 임시 자격 증명 교환이 프록시 구성의 영향을 받을 가능성을 줄입니다.
1.0.2(2026/04/24)¶
이번 릴리스는 반복 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
- CLI 및 설치 프로그램이 사용자 지정 Owl 작업 디렉터리를 지원합니다.
OWL_DIR,--owl-dir,-OwlDir를 추가했습니다. - 설치 프로그램이
OWL_OWNER/--owl-owner를 지원하여 cloud-init 또는 root 설치 후 구성 디렉터리를 서비스 사용자에게 넘길 수 있습니다. - 설치 완료 후 바이너리 경로를 Owl 디렉터리의
binpath에 기록하여 이후 업그레이드 및 Agent 런타임 위치 확인에 사용합니다.
문제 수정¶
- 설치 프로그램이
registry.endpoint및auth.token을 영구 저장할 때 현재 사용자 디렉터리에 고정 기록하는 문제를 수정했습니다. 이제 지정된 Owl 디렉터리에 기록합니다. - 사용자 지정 디렉터리 시나리오에서
config show가 디렉터리를 부정확하게 표시하는 문제를 수정했습니다.
기능 최적화¶
- README에 cloud-init / systemd 서비스 사용자 설치 설명을 추가하여
OWL_DIR및OWL_OWNER의 권장 사용법을 명확히 했습니다. - 설치 스크립트의 제거 안내, 구성 디렉터리 초기화, 경로 기록 로직이 모두 해석된 Owl 디렉터리를 사용하도록 통일했습니다.
1.0.1(2026/04/23)¶
이번 릴리스는 hotfix 수정에 해당하며 내용은 다음과 같습니다.
신규 기능¶
- CLI에 최초 사용 시 자동 동기화 기능을 추가했습니다. 로컬 캐시가 비어 있거나 캐시가
registry.sync_interval을 초과한 경우list,show,exec,schema,category등의 명령이 자동으로owl sync를 트리거합니다. sync.auto구성 항목을 추가하여 자동 동기화를 비활성화할 수 있습니다.
문제 수정¶
1.0.0Linux/macOS tar 패키지 내owl바이너리에 실행 권한이 누락된 문제를 수정했습니다.owl sync증분 동기화 시 원격에서 삭제된 category 캐시를 정리하지 않는 문제를 수정했습니다.HOME이 없는 일부 cloud-init / systemd / container 환경에서 설치 스크립트가set -u로 인해 조기 종료될 수 있는 문제를 수정했습니다.
기능 최적화¶
- 자동 동기화 실패 시 최초 동기화와 캐시 새로 고침을 구분합니다. 최초 동기화 실패는 오류를 반환하고, 기존 캐시 새로 고침 실패 시에는 이전 캐시를 유지하고 warning을 출력합니다.
- 릴리스 디렉터리에서
1.0.0및1.0.1channel 산출물을 복원하고 추적하며, installer 회귀 테스트와 CRLF/LF 감사를 보완했습니다.
1.0.0(2026/04/13)¶
이번 릴리스는 최초 릴리스에 해당하며 주요 업데이트는 다음과 같습니다.
신규 기능¶
- Owl CLI의 첫 channel 버전을 릴리스하여 Linux, macOS, Windows 총 5개 플랫폼 패키지를 제공합니다.
install.sh,install.ps1,owl-install.ps1및SHA256SUMS를 제공하여 원격 channel 설치, 지정 버전 설치, 로컬 패키지 설치 및 체크섬 검증을 지원합니다.- CLI는 구성 초기화, 로그인 시 token 기록, 도구 카탈로그 동기화, 분류 조회, 도구 조회, 도구 실행, OpenAI function schema 출력, 캐시 관리 및 데이터 파일 관리를 지원합니다.
기능 최적화¶
- 릴리스 디렉터리에 README 및 USAGE 문서를 포함하여 테스트/프로덕션 채널 설치, 런타임 구성, 오프라인 설치, 제거 및 일반 명령을 설명합니다.
- 빌드 파이프라인은 다중 플랫폼 교차 컴파일을 지원하며,
versionmanifest를 통해 현재 버전, 이전 버전, 릴리스 시간, commit 및 플랫폼 목록을 기록합니다.
알려진 문제¶
- Linux/macOS tar 패키지 내
owl바이너리 권한이0644여서 직접 압축 해제 후 실행할 수 없습니다. 이 문제는1.0.1에서 수정되었습니다.