Docs Menu
Docs Home
/ /

Atlas API ์ŠคํŠธ๋ฆผ downloadOperationalLogs

์ง€์ •๋œ Atlas Streams Processing ์ž‘์—… ๊ณต๊ฐ„ ๋˜๋Š” ์ŠคํŠธ๋ฆผ ํ”„๋กœ์„ธ์„œ์— ๋Œ€ํ•œ ์ž‘์—… ๋กœ๊ทธ๋ฅผ ๋‹ค์šด๋กœ๋“œ .

Atlas API ํ•˜์œ„ ๋ช…๋ น์€ MongoDB Atlas ๊ด€๋ฆฌ์ž API ์—์„œ ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋˜๋ฉฐ ๊ด€๋ฆฌ์ž API ์— ๋Œ€ํ•œ ์ „์ฒด ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๊ด€๋ฆฌ์ž API ์—ญ๋Ÿ‰์—๋Š” ์ž์ฒด ์ถœ์‹œ ์ˆ˜๋ช… ์ฃผ๊ธฐ๊ฐ€ ์žˆ์œผ๋ฉฐ, ์ด๋Š” ์ œ๊ณต๋œ API ์—”๋“œํฌ์ธํŠธ ๋ฌธ์„œ ๋งํฌ๋ฅผ ํ†ตํ•ด ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๊ธฐ๋ณธ๊ฐ’ ์œผ๋กœ ๋กœ๊ทธ๋Š” 30 ์ผ์˜ ๊ธฐ๊ฐ„์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค. ์ด ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉํ•˜๋ ค๋ฉด ์š”์ฒญํ•˜๋Š” ์„œ๋น„์Šค ๊ณ„์ • ๋˜๋Š” API ํ‚ค์— ํ”„๋กœ์ ํŠธ ๋ฐ์ดํ„ฐ ์•ก์„ธ์Šค ์—ญํ• , ํ”„๋กœ์ ํŠธ ์†Œ์œ ์ž ์—ญํ•  ๋˜๋Š” ํ”„๋กœ์ ํŠธ ์ŠคํŠธ๋ฆผ ์ฒ˜๋ฆฌ ์†Œ์œ ์ž ์—ญํ•  ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. API json ์‘๋‹ต ์Šคํ‚ค๋งˆ ์‚ฌ์šฉํ•œ ์ง์ ‘ ํ˜ธ์ถœ์„ ์ง€์› ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. 'Accept: ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ /vnd.atlas.2025-03-12+gzip' ํ˜•์‹์˜ ์ˆ˜๋ฝ ํ—ค๋”๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ gzip ์‘๋‹ต ์Šคํ‚ค๋งˆ ์š”์ฒญ ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ด ๋ช…๋ น์€ ์ž๋™์œผ๋กœ 1 ์ƒ์„ฑ๋˜๋ฉฐ:1 Atlas API ์—”๋“œํฌ์ธํŠธ https://www.mongodb.com/ko-kr/docs/api/doc/atlas-admin-api-v2/operation/์— ํ•ด๋‹นํ•ฉ๋‹ˆ๋‹ค. operation-downloadgroupstreamoperationallogs.

์ž์„ธํ•œ ๋‚ด์šฉ๊ณผ ์˜ˆ์‹œ๋Š” ์œ„์— ๋งํฌ๋œ ์ฐธ์กฐ API ๋ฌธ์„œ๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

๋ช…๋ น ๊ตฌ๋ฌธ
atlas api streams downloadOperationalLogs [options]
์ด๋ฆ„
์œ ํ˜•
ํ•„์ˆ˜ ์‚ฌํ•ญ
์„ค๋ช…

--endDate

int

๊ฑฐ์ง“

๋‹ค์šด๋กœ๋“œํ•  ๋กœ๊ทธ ๋ฉ”์‹œ์ง€ ๋ฒ”์œ„์˜ ์ข…๋ฃŒ ์ง€์ ์„ ์ง€์ •ํ•˜๋Š” ํƒ€์ž„์Šคํƒฌํ”„. MongoDB Cloud๋Š” ์œ ๋‹‰์Šค ์‹œ๊ฐ„ ์ดํ›„ ๊ฒฝ๊ณผ๋œ ์‹œ๊ฐ„(์ดˆ)์œผ๋กœ ์ด ํƒ€์ž„์Šคํƒฌํ”„๋ฅผ ํ‘œํ˜„ํ•ฉ๋‹ˆ๋‹ค.

--envelope

envelope

๊ฑฐ์ง“

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ์‘๋‹ต์„ ์—”๋ฒจ๋กœํ”„ JSON ๊ฐ์ฒด ๋กœ ๋ž˜ํ•‘ํ• ์ง€ ์—ฌ๋ถ€๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํ”Œ๋ž˜๊ทธ์ž…๋‹ˆ๋‹ค. ์ผ๋ถ€ API ํด๋ผ์ด์–ธํŠธ๋Š” HTTP ์‘๋‹ต ํ—ค๋” ๋˜๋Š” ์ƒํƒœ ์ฝ”๋“œ์— ์•ก์„ธ์Šค ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์ด ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๋ ค๋ฉด ์ฟผ๋ฆฌ ์—์„œ envelope=true ๋ฅผ ์„ค์ •ํ•˜๋‹ค . ๊ฒฐ๊ณผ ๋ชฉ๋ก์„ ๋ฐ˜ํ™˜ํ•˜๋Š” ์—”๋“œํฌ์ธํŠธ๋Š” ๊ฒฐ๊ณผ ๊ฐ์ฒด ์—”๋ฒจ๋กœํ”„๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ์‘๋‹ต ๋ณธ๋ฌธ์— ์ƒํƒœ ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.

--groupId

๋ฌธ์ž์—ด

true

ํ”„๋กœ์ ํŠธ ์‹๋ณ„ํ•˜๋Š” ๊ณ ์œ ํ•œ 24-16์ง„์ˆ˜ ๋ฌธ์ž์—ด์ž…๋‹ˆ๋‹ค. [/groups](# ํƒœ๊ทธ๋ฅผ ์ง€์ •ํ•˜๋‹ค /Projects/operation/listProjects) ์—”๋“œํฌ์ธํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ธ์ฆ๋œ ์‚ฌ์šฉ์ž๊ฐ€ ์•ก์„ธ์Šค ํ•  ์ˆ˜ ์žˆ๋Š” ๋ชจ๋“  ํ”„๋กœ์ ํŠธ๋ฅผ ์กฐํšŒ .

์ฐธ๊ณ : ๊ทธ๋ฃน๊ณผ ํ”„๋กœ์ ํŠธ๋Š” ๋™์˜์–ด์ž…๋‹ˆ๋‹ค. ๊ทธ๋ฃน ID๋Š” ํ”„๋กœ์ ํŠธ ID์™€ ๋™์ผํ•ฉ๋‹ˆ๋‹ค. ๊ธฐ์กด ๊ทธ๋ฃน์˜ ๊ฒฝ์šฐ, ๊ทธ๋ฃน/ํ”„๋กœ์ ํŠธ ID๋Š” ๋™์ผํ•˜๊ฒŒ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค. ๋ฆฌ์†Œ์Šค ๋ฐ ํ•ด๋‹น ์—”๋“œํฌ์ธํŠธ๋Š” ๊ทธ๋ฃน์ด๋ผ๋Š” ์šฉ์–ด๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

-h, --help

๊ฑฐ์ง“

downloadOperationalLogs์— ๋Œ€ํ•œ ๋„์›€๋ง

-o, --output

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๊ธฐ๋ณธ ์„ค์ • API ํ˜•์‹, ["gzip"] ๊ฐ€๋Šฅ ์ด ๊ฐ’์˜ ๊ธฐ๋ณธ๊ฐ’์€ "gzip"์ž…๋‹ˆ๋‹ค.

--outputFile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

API ์ถœ๋ ฅ์„ ์“ฐ๊ธฐ (write) ํŒŒ์ผ ์ž…๋‹ˆ๋‹ค. ์ด ํ”Œ๋ž˜๊ทธ๋Š” ์—”๋“œํฌ์ธํŠธ์˜ ์ถœ๋ ฅ์ด ๋ฐ”์ด๋„ˆ๋ฆฌ(์˜ˆ: gzip)์ด๊ณ  ๋ช…๋ น์ด ํŒŒ์ดํ”„๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ(์˜ˆ: Atlas ๋ช…๋ น > out.zip)์— ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

--spName

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๋กœ๊ทธ๋ฅผ ๋‹ค์šด๋กœ๋“œ ํ•  ์ŠคํŠธ๋ฆผ ํ”„๋กœ์„ธ์„œ์˜ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค. ๋นˆ ๋ฌธ์ž์—ด์€ ์ž‘์—… ๊ณต๊ฐ„์˜ ๋ชจ๋“  ์ŠคํŠธ๋ฆผ ํ”„๋กœ์„ธ์„œ์— ๋Œ€ํ•œ ๋กœ๊ทธ๋ฅผ ๋‹ค์šด๋กœ๋“œ ํ•ฉ๋‹ˆ๋‹ค.

--startDate

int

๊ฑฐ์ง“

๋‹ค์šด๋กœ๋“œํ•  ๋กœ๊ทธ ๋ฉ”์‹œ์ง€ ๋ฒ”์œ„์˜ ์‹œ์ž‘ ์ง€์ ์„ ์ง€์ •ํ•˜๋Š” ํƒ€์ž„์Šคํƒฌํ”„. MongoDB Cloud๋Š” ์œ ๋‹‰์Šค ์‹œ๊ฐ„ ์ดํ›„ ๊ฒฝ๊ณผ๋œ ์‹œ๊ฐ„(์ดˆ)์œผ๋กœ ์ด ํƒ€์ž„์Šคํƒฌํ”„๋ฅผ ํ‘œํ˜„ํ•ฉ๋‹ˆ๋‹ค.

--tenantName

๋ฌธ์ž์—ด

true

์ŠคํŠธ๋ฆผ ์ž‘์—… ๊ณต๊ฐ„์„ ์‹๋ณ„ํ•˜๋Š” ๋ ˆ์ด๋ธ”์ž…๋‹ˆ๋‹ค.

--version

๋ฌธ์ž์—ด

๊ฑฐ์ง“

API ํ˜ธ์ถœ ์‹œ ์‚ฌ์šฉํ•  API ๋ฒ„์ „ [์˜ต์…˜: "2025-03-12"], ๊ธฐ๋ณธ๊ฐ’์€ ์ตœ์‹  ๋ฒ„์ „ ๋˜๋Š” ํ”„๋กœํ•„ api_version ๊ตฌ์„ฑ ๊ฐ’( ์„ค์ •ํ•˜๋‹ค ๊ฒฝ์šฐ) ์ด ๊ฐ’ ๊ธฐ๋ณธ๊ฐ’์€ '2025-03-12".

์ด๋ฆ„
์œ ํ˜•
ํ•„์ˆ˜ ์‚ฌํ•ญ
์„ค๋ช…

-P, --profile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๊ตฌ์„ฑ ํŒŒ์ผ ์—์„œ ์‚ฌ์šฉํ•  ํ”„๋กœํ•„์˜ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค. Atlas CLI ์˜ ํ”„๋กœํ•„์— ๋Œ€ํ•ด ํ•™์Šต https://dochub.mongodb.org/core/atlas-cli-save-connection-settings๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

atlas api streams downloadOperationalLogs --version 2025-03-12 --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636466948e+09 --tenantName [tenantName]

๋Œ์•„๊ฐ€๊ธฐ

๊ฐ์‚ฌ ๋กœ๊ทธ ๋‹ค์šด๋กœ๋“œ

์ด ํŽ˜์ด์ง€์˜ ๋‚ด์šฉ