기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon DocumentDB 클러스터에 대한 설명 Amazon DocumentDB Management Console 또는 AWS CLI 를 사용하여 Amazon DocumentDB 클러스터와 관련된 연결 엔드포인트, 보안 그룹, VPCs 및 파라미터 그룹과 같은 세부 정보를 볼 수 있습니다. 자세한 내용은 다음을 참조하세요. + [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) + [클러스터 엔드포인트 찾기](db-cluster-endpoints-find.md) ------ #### [ Using the AWS Management Console ] 다음 절차에 따라 콘솔을 사용하여 지정된 Amazon DocumentDB 클러스터의 세부 정보를 확인합니다. 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. 클러스터 목록에서 세부 정보를 보려는 클러스터의 이름을 선택합니다. 클러스터에 대한 정보는 다음과 같은 그룹으로 구성됩니다. + **요약** - 엔진 버전, 클러스터 상태, 보류 중인 유지 관리 및 파라미터 그룹의 상태를 포함하여 클러스터에 대한 일반 정보입니다. + **연결 및 보안** - **연결** 섹션에는 mongo 쉘 또는 애플리케이션을 사용하여 이 클러스터에 연결할 연결 엔드포인트가 나열됩니다. **보안 그룹** 섹션에는 이 클러스터와 연결된 보안 그룹과 해당 VPC ID 및 설명이 나열됩니다. + **구성** - **클러스터 세부 정보** 섹션에는 클러스터의 Amazon 리소스 이름(ARN), 엔드포인트 및 파라미터 그룹을 포함하여 클러스터에 대한 세부 정보가 나열됩니다. 또한 클러스터의 백업 정보, 유지 관리 세부 정보, 보안 및 네트워크 설정이 나열됩니다. **클러스터 인스턴스** 섹션에는 각 인스턴스의 역할 및 클러스터 파라미터 그룹 상태와 함께 이 클러스터에 속하는 인스턴스가 나열됩니다. + **모니터링** - 이 클러스터의 Amazon CloudWatch Logs 측정치. 자세한 내용은 [CloudWatch를 사용하여 Amazon DocumentDB 모니터링](cloud_watch.md) 섹션을 참조하십시오. + **이벤트 및 태그** - **최근 이벤트** 섹션에는 이 클러스터의 최근 이벤트가 나열됩니다. Amazon DocumentDB에서는 클러스터, 인스턴스, 스냅샷, 보안 그룹 및 클러스터 파라미터 그룹과 관련된 이벤트 레코드를 유지합니다. 이 정보에는 각 이벤트와 연결된 날짜, 시간 및 메시지가 포함됩니다. **태그** 섹션에는 이 클러스터에 연결된 태그가 나열됩니다. ------ #### [ Using the AWS CLI ] 를 사용하여 Amazon DocumentDB 클러스터의 세부 정보를 보려면 아래 예제와 같이 `describe-db-clusters` 명령을 AWS CLI사용합니다. 자세한 내용은 *Amazon DocumentDB 리소스 관리 API 참조*에서 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html) 섹션을 참조하세요. **참고** 클러스터 및 인스턴스 수명주기 관리와 같은 특정 관리 기능의 경우 Amazon DocumentDB는 Amazon RDS와 공유하는 운영 기술을 활용합니다. `filterName=engine,Values=docdb` 필터 파라미터는 Amazon DocumentDB 클러스터만 반환합니다. **Example** **예 1: 모든 Amazon DocumentDB 클러스터를 나열합니다.** 다음 AWS CLI 코드는 리전의 모든 Amazon DocumentDB 클러스터에 대한 세부 정보를 나열합니다. ``` aws docdb describe-db-clusters --filter Name=engine,Values=docdb ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` { "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] } ``` **Example** **예 2: 지정된 Amazon DocumentDB 클러스터에 대한 모든 세부 정보 나열** 다음 AWS CLI 코드는 클러스터에 대한 세부 정보를 나열합니다`sample-cluster`. Linux, macOS, Unix의 경우: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster ``` Windows의 경우: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` { "DBClusters": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1c", "us-east-1a", "us-east-1d" ], "BackupRetentionPeriod": 2, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00", "Endpoint": "sample-cluster.node.us-east-1.amazon.com", "ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "5.0.0", "LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00", "Port": 27017, "MasterUsername": "chimeraAdmin", "PreferredBackupWindow": "22:22-22:52", "PreferredMaintenanceWindow": "sun:03:01-sun:03:31", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-9084c2ec", "Status": "active" } ], "HostedZoneId": "Z06853723JYKYBXTJ49RB", "StorageEncrypted": false, "DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "iopt1", "AutoMinorVersionUpgrade": false, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00" } ] } ``` **Example** **예 3: Amazon DocumentDB 클러스터에 대한 특정 세부 정보 나열** 를 사용하여 클러스터 세부 정보의 하위 집합을 나열하려면 `describe-db-clusters` 작업을 나열할 클러스터 멤버를 `--query` 지정하는를 AWS CLI추가합니다. `--db-cluster-identifier` 파라미터는 세부 정보를 표시할 특정 클러스터의 식별자입니다. 쿼리에 대한 자세한 내용은 *AWS Command Line Interface 사용 설명서*의 [`--query` 옵션을 사용하여 출력을 필터링하는 방법](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter)을 참조하세요. 다음 예제에서는 Amazon DocumentDB 클러스터의 인스턴스를 나열합니다. Linux, macOS, Unix의 경우: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` Windows의 경우: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterMembers]' ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ------