- ์ด ๋ฒ์ ์ ๋ฌธ์๋ ๋ณด๊ด๋์ด ๋ ์ด์ ์ง์๋์ง ์์ต๋๋ค. ์ต์ ๋ฌธ์ ๋ฅผ ์ฐธ์กฐํ์ฌ Atlas CLI ๋ฒ์ ์ ์ ๊ทธ๋ ์ด๋ ํ๋ ๋ฐฉ๋ฒ์ ํ์ต ๋ณด์ธ์.
๊ณต๊ฐ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ: ํผ๋๋ฐฑ ์ ๊ณต: ์ง์ ๋ ๋ค์์คํ์ด์ค ์ ๋ํ 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