Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

atlas api collectionLevelMetrics getCollStatsLatencyNamespaceClusterMeasurements

๊ณต๊ฐœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ: ํ”ผ๋“œ๋ฐฑ ์ œ๊ณต: ์ง€์ •๋œ ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์— ๋Œ€ํ•œ Coll Stats ์ง€์—ฐ ์‹œ๊ฐ„ ํด๋Ÿฌ์Šคํ„ฐ ์ˆ˜์ค€ ์ธก์ •๊ฐ’ ๋ชฉ๋ก์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

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

์ด ๋ช…๋ น์€ ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋˜๋ฉฐ 1 1 Atlas API ์—”๋“œํฌ์ธํŠธ https://www.mongodb.com/ko-kr/docs/atlas/reference/api-resources-spec/v2/# ํƒœ๊ทธ๋ฅผ ์ง€์ •ํ•˜๋‹ค/Collection- Level-Metrics/operation/getCollStatsLatencyNamespaceClusterMeasurements.

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

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

--clusterName

๋ฌธ์ž์—ด

true

์‚ฌ๋žŒ์ด ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ๋ ˆ์ด๋ธ”๋กœ, ์ง€ํ‘œ๋ฅผ ์กฐํšŒํ•  ํด๋Ÿฌ์Šคํ„ฐ๋ฅผ ์‹๋ณ„ํ•ฉ๋‹ˆ๋‹ค.

--clusterView

๋ฌธ์ž์—ด

true

์‚ฌ๋žŒ์ด ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ๋ ˆ์ด๋ธ”๋กœ, ์ง€ํ‘œ๋ฅผ ์กฐํšŒํ•  ํด๋Ÿฌ์Šคํ„ฐ ํ† ํด๋กœ์ง€๋ฅผ ์‹๋ณ„ํ•ฉ๋‹ˆ๋‹ค.

--collectionName

๋ฌธ์ž์—ด

true

์ปฌ๋ ‰์…˜์„ ์‹๋ณ„ํ•˜๋Š” ์‚ฌ๋žŒ์ด ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ๋ ˆ์ด๋ธ”์ž…๋‹ˆ๋‹ค.

--databaseName

๋ฌธ์ž์—ด

true

๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ฅผ ์‹๋ณ„ํ•˜๋Š” ์‚ฌ๋žŒ์ด ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ๋ ˆ์ด๋ธ”์ž…๋‹ˆ๋‹ค.

--end

๋ฌธ์ž์—ด

๊ฑฐ์ง“

MongoDB ํด๋ผ์šฐ๋“œ๊ฐ€ ๋ฉ”ํŠธ๋ฆญ ๋ณด๊ณ ๋ฅผ ์ค‘๋‹จํ•˜๋Š” ๋‚ ์งœ ๋ฐ ์‹œ๊ฐ„์ž…๋‹ˆ๋‹ค. ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋Š” UTC ๋‹จ์œ„์˜ ISO 8601 ํƒ€์ž„์Šคํƒฌํ”„ ํ˜•์‹์œผ๋กœ ๊ฐ’์„ ํ‘œํ˜„ํ•ฉ๋‹ˆ๋‹ค. ๊ธฐ๊ฐ„์„ ์„ค์ •ํ•˜์ง€ ์•Š์„ ๊ฒฝ์šฐ ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ํฌํ•จํ•˜์„ธ์š”.

--envelope

envelope

๊ฑฐ์ง“

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

--groupId

๋ฌธ์ž์—ด

true

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

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

-h, --help

๊ฑฐ์ง“

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

--metrics

๋ฌธ์ž์—ด ๋ฐฐ์—ด

๊ฑฐ์ง“

๊ด€๋ จ ๋ฐ์ดํ„ฐ ๊ณ„์—ด์— ๋Œ€ํ•ด ์กฐํšŒํ•˜๋ ค๋Š” ์ง€ํ‘œ๊ฐ€ ํฌํ•จ๋œ ๋ชฉ๋ก์ž…๋‹ˆ๋‹ค. ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์„ค์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ์ด ๋ฆฌ์†Œ์Šค๋Š” ๋ชจ๋“  ์ปฌ๋ ‰์…˜ ์ง€์—ฐ ์‹œ๊ฐ„ ํ†ต๊ณ„ ์ง€ํ‘œ์— ๋Œ€ํ•œ ๋ฐ์ดํ„ฐ ๊ณ„์—ด์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

-o, --output

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

--outputFile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

--period

๋ฌธ์ž์—ด

๊ฑฐ์ง“

Atlas๊ฐ€ ๋ฉ”ํŠธ๋ฆญ์„ ๋ณด๊ณ ํ•˜๋Š” ๊ธฐ๊ฐ„์ž…๋‹ˆ๋‹ค. ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋Š” UTC ๋‹จ์œ„์˜ ISO 8601 ๊ธฐ๊ฐ„ ํ˜•์‹์œผ๋กœ ๊ฐ’์„ ํ‘œํ˜„ํ•ฉ๋‹ˆ๋‹ค. ์‹œ์ž‘๊ณผ ๋์„ ์„ค์ •ํ•˜์ง€ ์•Š์„ ๊ฒฝ์šฐ ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ํฌํ•จํ•˜์„ธ์š”.

--start

๋ฌธ์ž์—ด

๊ฑฐ์ง“

MongoDB Cloud๊ฐ€ ์ธก์ •ํ•ญ๋ชฉ ๋ณด๊ณ ๋ฅผ ์‹œ์ž‘ํ•œ ๋‚ ์งœ ๋ฐ ์‹œ๊ฐ„์ž…๋‹ˆ๋‹ค. ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋Š” UTC ๋‹จ์œ„์˜ ISO 8601 ํƒ€์ž„์Šคํƒฌํ”„ ํ˜•์‹์œผ๋กœ ๊ฐ’์„ ํ‘œํ˜„ํ•ฉ๋‹ˆ๋‹ค. ๊ธฐ๊ฐ„์„ ์„ค์ •ํ•˜์ง€ ์•Š์„ ๊ฒฝ์šฐ ์ด ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ํฌํ•จํ•˜์„ธ์š”.

--version

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

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

-P, --profile

๋ฌธ์ž์—ด

๊ฑฐ์ง“

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

atlas api collectionLevelMetrics getCollStatsLatencyNamespaceClusterMeasurements --version 2023-11-15 --clusterName [clusterName] --clusterView [clusterView] --collectionName mycoll --databaseName mydb --groupId 32b6e34b3d91647abb20e7b8 --period PT10H

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

์ปฌ๋ ‰์…˜ ์ˆ˜์ค€ ์ง€ํ‘œ

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