프로젝트 수준의 OTLP 추적 내보내기 설정을 저장합니다. 인증 시크릿은 참조만 가능합니다(headers_secret_ref). 원시 값은 허용되거나 저장되지 않습니다. 생성 카운터를 충돌시키고 구성을 다운스트림 전송을 위해 보류 중으로 표시합니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.
body
필수 사항
입력된 JSON 구성
-
ContentMode는 스팬 콘텐츠 편집을 선택합니다. 비어 있음은 metadata_only를 의미합니다.
값은
metadata_only또는full입니다. -
EgressMode는 스팬이 전달될 위치를 선택합니다. 비어 있음은 platform_only를 의미합니다.
값은
platform_only,platform_and_customer_mirror또는customer_only입니다. -
Enabled는 포인터이므로 핸들러가 생략된 필드 (nil, 거부됨)와 명시적인 false(유효한 "내보내기 비활성화" 요청)를 구분할 수 있습니다.
-
엔드포인트는 고객의 OTLP/ HTTP 엔드포인트입니다. 활성화된 경우 필수입니다. https여야 하며 내부/루프백 주소 점 않아야 합니다(유효성 검사 참조).
최대 길이는
2048입니다. -
헤더는 사전 설정에 필요한 NON-SECRET 내보내기 헤더(예: 작업 공간 ID)를 보유합니다. 시크릿 값은 여기에 배치하지 않아야 하며, HeadersSecretRef를 사용하세요.
-
HeadersSecretRef는 저장된 단일 인증 시크릿(일반적으로 API 키)에 대한 포인터입니다. 이는 참조이며 절대 비밀 값이 아닙니다. 호출자의 프로젝트 로 범위를 지정해야 합니다(유효성 검사 참조).
최대 길이는
512입니다. -
InsecureSkipVerify는 고객 엔드포인트의 TLS 확인을 비활성화합니다. 포인터가 있으므로 nil(verify, 기본값)은 명시적 옵트아웃과 구별됩니다. UI 표면을 통해 의도적인 보안 감소로 이를 가능하게 합니다.
-
프로토콜은 아웃바운드 OTLP 프로토콜 입니다. v1는 http/protobuf만 지원합니다.
값은
http/protobuf입니다. -
ResourceAttributes는 고객 엔드포인트로 전송되는 모든 범위에 스탬프 처리된 예비 OTLP 리소스 속성입니다(예: 대상 필수 프로젝트/model 식별자). 특정 대상에 필요한 키는 해당 사전 설정에서 비롯됩니다(pkg/traceexportconfig/presets 참조). 값은 일반적으로 대상 자체 측에서 이 플랫폼이 조회할 방법이 없는 프로젝트 의 이름을 지정하기 때문에 항상 고객이 제공합니다.
-
SamplingPolicy는 내보내기 전에 적용된 헤드 샘플러를 선택합니다.
-
SecretHeaderName은 참조된 시크릿 값이 전송되는 헤더 이름(예: 'api_key')으로, 사전 설정의 secret_header_keys에서 가져오거나 사용자 지정 대상에 대해 사용자가 입력한 헤더 이름입니다. 이 플랫폼은 아웃바운드 " 따라서 저장된 시크릿은 항상 베어 값입니다(사전 형식의 헤더 라인이 아님). HeadersSecretRef가 설정하다 경우 필수입니다(유효성 검사 참조).
최대 길이는
128입니다.
curl \
--request PUT 'https://agentengine.mongodb.com/api/v1/projects/{id}/trace-export/config' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"content_mode": "metadata_only",
"egress_mode": "platform_only",
"enabled": true,
"endpoint": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"headers_secret_ref": "string",
"insecure_skip_verify": true,
"protocol": "http/protobuf",
"resource_attributes": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"sampling_policy": {
"ratio": 42.0,
"type": "always_on"
},
"secret_header_name": "string"
}'{
"content_mode": "metadata_only",
"egress_mode": "platform_only",
"enabled": true,
"endpoint": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"headers_secret_ref": "string",
"insecure_skip_verify": true,
"protocol": "http/protobuf",
"resource_attributes": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"sampling_policy": {
"ratio": 42.0,
"type": "always_on"
},
"secret_header_name": "string"
}{
"detail": "This operation is not available in API version 2026-09-20-preview.",
"error": 406,
"errorCode": "OPERATION_NOT_IN_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
"error": 406,
"errorCode": "UNACCEPTABLE_MEDIA_TYPE",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
"error": 406,
"errorCode": "UNSUPPORTED_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"detail": "This operation is not available in API version 2026-09-20-preview.",
"error": 406,
"errorCode": "OPERATION_NOT_IN_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}{
"generation": 42,
"updated_at": "string"
}{
"generation": 42,
"updated_at": "string"
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}