요청 로그

OfoxAI는 기본적으로 Zero Data Retention(ZDR)이 적용되어 요청 내용을 저장하지 않습니다. 문제를 조사해야 할 때 팀에서 「로그 보존(Log retention)」을 켜면 콘솔에서 요청마다 전체 입력과 출력을 하나씩 확인할 수 있습니다.

요청 로그는 기본적으로 꺼져 있습니다. 켜지 않은 팀은 요청 내용이 저장되지 않으며, 켜기 전에 보낸 요청은 나중에 확인할 수 없습니다.

확인할 수 있는 내용

켜면 새 요청의 입력, 출력, 도구 호출, 오류 원인이 저장됩니다. 요청과 응답에 포함된 이미지는 「이미지도 저장(Also save images)」을 따로 선택해야 저장됩니다.

활동(Activity) 에서 로그가 있는 요청에는 표시가 붙습니다. 열면 해당 요청의 각 단계를 타임라인으로 볼 수 있고, 소요 시간, 토큰, 비용 등의 요약도 함께 표시됩니다.

로그 보존 켜기

팀 소유자와 관리자만 켤 수 있습니다.

콘솔 에서 활동(Activity) 을 엽니다
오른쪽 위의 로그 보존(Log retention) 을 클릭합니다
로그 보존 켜기(Turn on log retention) 를 클릭합니다
「저장할 요청(Which requests to save)」에서 범위를 선택합니다:
- 모든 API Key(All API keys): 일부 Key를 제외할 수 있습니다
- 지정한 API Key(Selected API keys): 목록에 있는 Key만 저장합니다
필요하면 「이미지도 저장(Also save images)」을 선택합니다

설정은 이후의 새 요청에만 적용됩니다.

보관 한도

항목	한도
보관 기간	최근 3일
보관 건수	최근 1만 건
저장 용량	1 GB

어느 한 항목이라도 한도에 도달하면 가장 오래된 로그부터 자동으로 삭제됩니다. 더 오래 보관해야 한다면 hi@ofox.ai로 메일을 보내 주세요.

민감 정보 처리

저장 전에 API Key, 토큰, 비밀번호, Cookie, 개인 키, 서명된 URL 파라미터는 [REDACTED]로 바뀝니다.

전화번호, 이메일 등 개인정보는 처리되지 않습니다. 요청에 사용자의 개인 데이터가 포함된다면 켜기 전에 검토하거나, 아래 요청 헤더로 저장을 건너뛰세요.

특정 요청만 저장하지 않기

요청에 다음 헤더를 추가하면 해당 요청은 저장되지 않습니다:


X-OfoxAI-Log-Content: off


from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.ofox.ai/v1",
    api_key="<OFOXAI_API_KEY>",
)
 
response = client.chat.completions.create(
    model="anthropic/claude-sonnet-5.5",
    messages=[{"role": "user", "content": "이 요청은 로그를 저장하지 않습니다"}],
    extra_headers={"X-OfoxAI-Log-Content": "off"},
)

조회 권한

작업	팀 소유자 / 관리자	일반 멤버
켜기, 끄기, 범위 변경	✅	❌
로그 내용 조회	✅	❌
로그 삭제	✅	❌

일반 멤버가 특정 요청의 전체 내용을 확인해야 한다면 팀 관리자에게 문의하세요.

삭제와 끄기

단일 로그 삭제: 요청 상세 화면에서 삭제합니다.
기간별 삭제: 로그 보존 설정에서 「저장된 로그 삭제」를 클릭하고 최근 1시간, 오늘, 전체 또는 사용자 지정 기간을 선택할 수 있습니다. 삭제한 로그는 복구할 수 없으며, 호출 기록, 토큰 사용량, 비용에는 영향이 없습니다.
로그 보존 끄기: 끄면 새 요청은 더 이상 저장되지 않습니다. 이미 저장된 로그는 바로 삭제되지 않고 보관 기간이 끝나면 자동으로 삭제됩니다. 즉시 삭제하려면 위의 삭제 기능을 사용하세요.

자주 묻는 질문

요청을 열었을 때 「이 요청은 로그가 저장되지 않았습니다」라고 나오는 이유는 무엇인가요?

다음 중 하나일 수 있습니다: 요청이 로그 보존을 켜기 전에 발생했거나, 해당 API Key가 저장 범위에 포함되지 않았거나, 요청에 X-OfoxAI-Log-Content: off가 붙어 있었거나, 로그가 만료되었거나 삭제되었습니다.

로그를 켜면 추가 요금이 있나요?

없습니다. 로그 보존에는 추가 요금이 없으며 호출 기록, 토큰 사용량, 과금 방식도 그대로입니다.

Zero Data Retention(ZDR)과는 어떤 관계인가요?

로그 보존을 켜지 않은 팀은 계속 Zero Data Retention이 적용됩니다. 켜면 저장 범위에 포함된 요청 내용이 위의 한도 내에서 저장됩니다. 자세한 내용은 보안 및 데이터를 참고하세요.