기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon CloudWatch를 사용하여 지표 보기
고객 응대 중에는 데이터를 AWS Ground Station 자동으로 캡처하여 분석을 위해 CloudWatch로 전송합니다. Amazon CloudWatch 콘솔에서 데이터를 볼 수 있습니다. 액세스 및 CloudWatch 지표에 대한 자세한 내용은 [Amazon CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)을 참조하세요.
AWS Ground Station 원격 측정 기능을 사용하여 연락 중에 거의 실시간에 가까운 지표를 수신할 수도 있습니다. CloudWatch 지표는 거의 실시간으로 사용할 수 없으며 전송이 지연될 수 있습니다. 또한 CloudWatch는 1초 동안 지표를 집계하여 잠재적으로 데이터 세분화를 줄일 수 있습니다. 원격 측정 기능은 개별 지표를 제공하고 거의 실시간으로 AWS 계정에 직접 제공합니다. 자세한 내용은 [원격 측정 작업](telemetry.md) 단원을 참조하십시오.
**중요**
AWS Ground Station 는 고객 응대가 예약된 AWS 리전이 아닌 고객 응대의 지상국 위치와 연결된 AWS 리전으로 CloudWatch 지표를 내보냅니다. 연락처에 대한 지표를 보려면 지상국 리전의 CloudWatch에 액세스해야 합니다. 각 지상국 위치와 연결된 리전에 대한 AWS 자세한 내용은 섹션을 참조하세요[지상국 위치의 AWS 리전 찾기](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). 연락처를 예약하는 리전에서 원격 측정 데이터를 수신하려면 AWS Ground Station 원격 측정 기능을 사용할 수 있습니다. 자세한 내용은 [원격 측정 작업](telemetry.md) 섹션을 참조하세요.
## AWS Ground Station 지표 및 차원
### 사용할 수 있는 지표는 무엇입니까?
다음 지표는에서 사용할 수 있습니다 AWS Ground Station.
**참고**
내보내는 특정 지표는 사용 중인 AWS Ground Station 기능에 따라 달라집니다. 구성에 따라 아래 지표의 하위 집합만 내보내질 수 있습니다.
| 지표 | 측정치 차원 | 설명 |
| --- | --- | --- |
| `AzimuthAngle` | SatelliteId | 안테나의 방위각. 진북쪽은 0도이고 동쪽은 90도입니다.
단위: 도 |
| `BitErrorRate` | 채널, 편광, SatelliteId | 지정된 비트 전송 횟수에서 비트에 대한 오류율입니다. 비트 오류는 노이즈, 왜곡 또는 간섭으로 인해 발생합니다.
단위: 단위 시간당 비트 오류 |
| `BlockErrorRate` | 채널, 편광, SatelliteId | 지정된 수신 블록의 수에서 블록의 오류율입니다. 블록 오류는 간섭으로 인해 발생합니다.
단위: 잘못된 블록/총 블록 수 |
| `CarrierFrequencyRecovery_Cn0` | 범주, 구성, SatelliteId | 단위 대역폭당 캐리어 대 잡음 밀도 비율.
단위: 데시벨-헤르츠(dB-Hz) |
| `CarrierFrequencyRecovery_Locked` | 범주, 구성, SatelliteId | 복조기 캐리어 주파수 복구 루프가 잠겨 있으면 1로 설정하고 잠금 해제되면 0으로 설정합니다.
단위: 단위 없음 |
| `CarrierFrequencyRecovery_OffsetFrequency_Hz` | 범주, 구성, SatelliteId | 추정된 신호 중심과 이상적인 중심 주파수 사이의 오프셋. 이는 우주선과 안테나 시스템 사이의 도플러 시프트 및 로컬 오실레이터 오프셋으로 인해 발생합니다.
단위: 헤르츠(Hz) |
| `ElevationAngle` | SatelliteId | 안테나의 고도 각도. 수평선은 0도이고 천정은 90도입니다.
단위: 도 |
| `Es/N0` | 채널, 편광, SatelliteId | 심볼당 에너지 대 노이즈 파워 스펙트럼 밀도의 비율.
단위: 데시벨(dB) |
| `ReceivedPower` | 편광, SatelliteId | 복조기/디코더에서 측정된 신호 강도입니다.
단위: 밀리와트에 상응하는 데시벨(dBm) |
| `SymbolTimingRecovery_ErrorVectorMagnitude` | 범주, 구성, SatelliteId | 수신된 심볼과 이상적인 성상점 사이의 오차 벡터 크기.
단위: 백분율 |
| `SymbolTimingRecovery_Locked` | 범주, 구성, SatelliteId | 복조기 심볼 타이밍 복구 루프가 잠겨 있으면 1로 설정하고, 잠금이 해제되면 0으로 설정합니다.
단위: 단위 없음 |
| `SymbolTimingRecovery_OffsetSymbolRate` | 범주, 구성, SatelliteId | 추정된 심볼 레이트와 이상적인 신호 심볼 레이트 사이의 오프셋. 이는 우주선과 안테나 시스템 사이의 도플러 시프트 및 로컬 오실레이터 오프셋으로 인해 발생합니다.
단위: 기호/초 |
### 어떤 차원에 사용되나요 AWS Ground Station?
다음 차원을 사용하여 AWS Ground Station 데이터를 필터링할 수 있습니다.
| 차원 | 설명 |
| --- | --- |
| `Category` | 복조 또는 디코딩. |
| `Channel` | 각 접촉에 대한 채널에는 1, 2, I(동상) 및 Q(직교)가 포함됩니다. |
| `Config` | 안테나 다운링크 데모 디코딩 구성 ARN. |
| `Polarization` | 각 접촉에 대한 편광에는 LHCP(Left Hand Circular Polarized) 또는 RHCP(Right Hand Circular Polarized)가 포함됩니다. |
| `SatelliteId` | 위성 ID에는 접촉에 대한 위성의 ARN이 포함됩니다. |
## 지표 보기
그래프로 표시된 지표를 볼 때 집계 창에서 지표가 표시되는 방법이 결정된다는 점에 유의해야 합니다. 접촉의 각 지표는 데이터를 받은 후 3시간 동안 초당 데이터로 표시될 수 있습니다. 데이터는 3시간이 경과한 후 CloudWatch 지표에 의해 분당 데이터로 집계됩니다. 초당 데이터에 대한 지표를 확인해야 하는 경우 데이터를 수신한 후 3시간 이내에 데이터를 보거나 CloudWatch 지표 외부에서 유지하는 것이 좋습니다. CloudWatch 보존에 대한 자세한 내용은 [Amazon CloudWatch 개념 - 지표 보존을](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#metrics-retention) 참조하세요.
또한 처음 60초 내에 캡처된 데이터에는 의미 있는 지표를 생성하기에 충분한 정보가 포함되지 않으며 표시되지 않을 수 있습니다. 의미 있는 지표를 보려면 60초 후에 데이터를 보는 것이 좋습니다.
CloudWatch의 지표 그래프 작성 AWS Ground Station 에 대한 자세한 내용은 [지표 그래프 작성을 참조하세요](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html).
### 콘솔을 사용한 메트릭 확인
1. 지상국 위치와 연결된 AWS 리전을 결정합니다. AWS Ground Station 는 연락처의 지상국 위치와 연결된 리전에서 CloudWatch 지표를 내보냅니다. 지상국 위치 및 관련 AWS 리전 목록은 섹션을 참조하세요[지상국 위치의 AWS 리전 찾기](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions).
1. [ CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch)을 엽니다.
1. 탐색 창에서 **지표**를 선택합니다.
1. **GroundStation** 네임스페이스를 선택합니다.
1. 원하는 지표 차원(예: **채널, 편광, SatelliteId**)을 선택합니다.
1. **모든 지표** 탭에 네임스페이스의 해당 측정기준에 대한 모든 지표가 표시됩니다. 다음을 수행할 수 있습니다.
1. 테이블을 정렬하려면 열 머리글을 사용합니다.
1. 지표를 그래프로 표시하려면 지표와 연결된 확인란을 선택합니다. 모든 지표를 선택하려면 테이블의 제목 행에서 확인란을 선택합니다.
1. 리소스로 필터링하려면 리소스 ID를 선택한 후 **검색에 추가**를 선택합니다.
1. 지표로 필터링하려면 지표 이름을 선택한 후 **검색에 추가**를 선택합니다.
### 를 사용하여 지표를 보려면 AWS CLI
AWS Ground Station 는 연락처의 지상국 위치와 연결된 리전에서 CloudWatch 지표를 내보냅니다. 연결된 AWS 리전의 지상국 위치 목록은 섹션을 참조하세요[지상국 위치의 AWS 리전 찾기](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). {{ ground-station-region-code}}를 해당 지상국 위치의 AWS 리전 코드로 바꿉니다(예: 오레곤 1, 하와이 1 또는 알래스카 1의 `us-west-2` 경우). 이 절차의 모든 후속 AWS CLI 명령은 동일한 리전을 사용해야 합니다.
1. AWS CLI 가 설치되어 있는지 확인합니다. 설치에 대한 자세한 내용은 AWS CLI 버전 2 설치를 AWS CLI참조하세요. [https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
1. 지상국 위치와 연결된 AWS 리전을 식별합니다.
1. CloudWatch CLI의 [get-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) 메서드를 사용하여 관심 있는 지표를 지정하도록 수정할 수 있는 파일을 생성한 다음 해당 지표를 쿼리하는 데 사용됩니다.
이렇게 하려면를 실행합니다`aws cloudwatch get-metric-data --region {{ ground-station-region-code}} --generate-cli-skeleton`. 이렇게 하면 다음과 비슷한 출력이 생성됩니다.
```
{
"MetricDataQueries": [
{
"Id": "",
"MetricStat": {
"Metric": {
"Namespace": "",
"MetricName": "",
"Dimensions": [
{
"Name": "",
"Value": ""
}
]
},
"Period": 0,
"Stat": "",
"Unit": "Seconds"
},
"Expression": "",
"Label": "",
"ReturnData": true,
"Period": 0,
"AccountId": ""
} ],
"StartTime": "1970-01-01T00:00:00",
"EndTime": "1970-01-01T00:00:00",
"NextToken": "",
"ScanBy": "TimestampDescending",
"MaxDatapoints": 0,
"LabelOptions": {
"Timezone": ""
}
}
```
1. 를 실행하여 사용 가능한 CloudWatch 지표를 나열`aws cloudwatch list-metrics --region {{ground-station-region-code}}`합니다.
최근에 AWS Ground Station를 사용한 경우 메서드는 다음과 같은 항목이 포함된 출력을 반환해야 합니다.
```
...
{
"Namespace": "AWS/GroundStation",
"MetricName": "ReceivedPower",
"Dimensions": [
{
"Name": "Polarization",
"Value": "LHCP"
},
{
"Name": "SatelliteId",
"Value": "arn:aws:groundstation::111111111111:satellite/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}
]
},
...
```
**참고**
마지막으로 사용한 후 2주가 지난 경우 사용 [가능한 지표 테이블](#monitoring.metrics.metrics-and-dimensions.available-metrics)을 수동으로 검사하여 지표 ` AWS/GroundStation` 네임스페이스에서 지표 이름과 차원을 찾아 AWS Ground Station야 합니다. CloudWatch 제한 사항에 대한 자세한 내용은 다음을 참조하세요. [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)
1. 2단계에서 생성한 JSON 파일을와 같은 3단계`SatelliteId`의 필수 값과 지표`Polarization`의 필수 값과 일치하도록 수정합니다. 또한 연락처와 일치하도록 `StartTime`, 및 `EndTime` 값을 업데이트해야 합니다. 예제:
```
{
"MetricDataQueries": [
{
"Id": "receivedPowerExample",
"MetricStat": {
"Metric": {
"Namespace": "AWS/GroundStation",
"MetricName": "ReceivedPower",
"Dimensions": [
{
"Name": "SatelliteId",
"Value": "arn:aws:groundstation::111111111111:satellite/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
},
{
"Name": "Polarization",
"Value": "RHCP"
}
]
},
"Period": 300,
"Stat": "Maximum",
"Unit": "None"
},
"Label": "ReceivedPowerExample",
"ReturnData": true
}
],
"StartTime": "2024-02-08T00:00:00",
"EndTime": "2024-04-09T00:00:00"
}
```
**참고**
AWS Ground Station 는 지표에 따라 1\~60초마다 지표를 게시합니다. `Period` 필드에 지표의 게시 기간보다 작은 값이 있는 경우 지표가 반환되지 않습니다.
1. 이전 단계에서 생성한 `aws cloudwatch get-metric-data` 구성 파일로를 실행합니다. 아래에 예제가 나와 있습니다.
```
aws cloudwatch get-metric-data --region {{ground-station-region-code}} --cli-input-json file://.json
```
지표는 접촉의 타임스탬프와 함께 제공됩니다. AWS Ground Station 지표 출력의 예는 아래에 나와 있습니다.
```
{
"MetricDataResults": [
{
"Id": "receivedPowerExample",
"Label": "ReceivedPowerExample",
"Timestamps": [
"2024-04-08T18:35:00+00:00",
"2024-04-08T18:30:00+00:00",
"2024-04-08T18:25:00+00:00"
],
"Values": [
-33.30191555023193,
-31.46100273132324,
-32.13915576934814
],
"StatusCode": "Complete"
}
],
"Messages": []
}
```