Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

atlas api monitoringAndLogs getDatabase

๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ: ํ”ผ๋“œ๋ฐฑ ์ œ๊ณตํ•˜์„ธ์š”: ์ง€์ •๋œ ํ”„๋กœ์ ํŠธ์˜ ์ง€์ •๋œ ํ˜ธ์ŠคํŠธ์—์„œ ์‹คํ–‰ ์ค‘์ธ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํ•˜๋‚˜๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

MongoDB Atlas Admin API ์—์„œ ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋œ Atlas API ํ•˜์œ„ ๋ช…๋ น์€ Admin API ์— ๋Œ€ํ•œ ์ „์ฒด ๋ฒ”์œ„๋ฅผ ์ œ๊ณตํ•˜๋ฉฐ ํ˜„์žฌ Public Preview(๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ) ์ค‘์ž…๋‹ˆ๋‹ค( ํ”ผ๋“œ๋ฐฑ https://ํ”ผ๋“œ๋ฐฑ.mongodb.com/forums/930808-Atlas-cli). ๊ด€๋ฆฌ์ž API ๊ธฐ๋Šฅ์—๋Š” ์ž์ฒด ์ถœ์‹œํ•˜๋‹ค ์ˆ˜๋ช… ์ฃผ๊ธฐ๊ฐ€ ์žˆ์œผ๋ฉฐ, ์ด๋Š” ์ œ๊ณต๋œ API ์—”๋“œํฌ์ธํŠธ ๋ฌธ์„œ ๋งํฌ๋ฅผ ํ†ตํ•ด ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉํ•˜๋ ค๋ฉด ์š”์ฒญํ•˜๋Š” ์„œ๋น„์Šค ๊ณ„์ • ๋˜๋Š” API ํ‚ค์— ํ”„๋กœ์ ํŠธ ์ฝ๊ธฐ ์ „์šฉ ์—ญํ•  ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

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

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

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

--databaseName

๋ฌธ์ž์—ด

true

์ง€์ •๋œ MongoDB ํ”„๋กœ์„ธ์Šค๊ฐ€ ์ œ๊ณตํ•˜๋Š” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ฅผ ์‹๋ณ„ํ•˜๋Š” ์‚ฌ๋žŒ์ด ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ๋ ˆ์ด๋ธ”์ž…๋‹ˆ๋‹ค.

--envelope

envelope

๊ฑฐ์ง“

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

--groupId

๋ฌธ์ž์—ด

true

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

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

-h, --help

๊ฑฐ์ง“

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

-o, --output

๋ฌธ์ž์—ด

๊ฑฐ์ง“

๊ธฐ๋ณธ ์„ค์ • API ํ˜•์‹์€ ["JSON", go- Template] ์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ๊ฐ’์˜ ๊ธฐ๋ณธ๊ฐ’์€ "JSON" ์ž…๋‹ˆ๋‹ค.

--outputFile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

--pretty

๊ฑฐ์ง“

์‘๋‹ต ๋ณธ๋ฌธ์ด ํ”„๋ฆฌํ‹ฐํ”„๋ฆฐํŠธ ํ˜•์‹์ด์–ด์•ผ ํ•˜๋Š”์ง€ ์—ฌ๋ถ€๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํ”Œ๋ž˜๊ทธ์ž…๋‹ˆ๋‹ค.

--processId

mongod

true

MongoDB ํ”„๋กœ์„ธ์Šค ์ œ๊ณตํ•˜๋Š” ํ˜ธ์ŠคํŠธ ์ด๋ฆ„๊ณผ IANA(Internet Assigned Numbers Authority) ํฌํŠธ์˜ ์กฐํ•ฉ์ž…๋‹ˆ๋‹ค. ํ˜ธ์ŠคํŒ…ํ•˜๋‹ค MongoDB ํ”„๋กœ์„ธ์Šค (mongod ๋˜๋Š” mongos)๋ฅผ ์‹คํ–‰ํ•˜๋Š” ํ˜ธ์ŠคํŒ…ํ•˜๋‹ค ์˜ ํ˜ธ์ŠคํŠธ ์ด๋ฆ„, FQDN(์ •๊ทœํ™”๋œ ๋„๋ฉ”์ธ ์ด๋ฆ„) ๋˜๋Š” ์ธํ„ฐ๋„ท ํ”„๋กœํ† ์ฝœ ์ฃผ์†Œ (IPv4 ๋˜๋Š” IPv6)์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค. ํฌํŠธ๋Š” MongoDB ํ”„๋กœ์„ธ์Šค ์š”์ฒญ์„ ์ˆ˜์‹ ํ•˜๋Š” IANA ํฌํŠธ์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.

--version

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

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

-P, --profile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

atlas api monitoringAndLogs getDatabase --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017

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

getAtlasProcess

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