Consulta las métricas con Amazon CloudWatch - AWS Ground Station

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Consulta las métricas con Amazon CloudWatch

Durante un contacto, captura y envía AWS Ground Station automáticamente los datos CloudWatch para su análisis. Tus datos se pueden ver en la CloudWatch consola de Amazon. Para obtener más información sobre el acceso y CloudWatch las métricas, consulta Uso de Amazon CloudWatch Metrics.

importante

AWS Ground Station emite CloudWatch las métricas a la AWS región asociada a la ubicación de la estación terrestre del contacto, no a la AWS región desde la que se programó el contacto. Para ver las métricas de un contacto, debes acceder a la CloudWatch región de la estación terrestre. Para obtener información sobre qué AWS región está asociada a cada ubicación de la estación terrestre, consulteBúsqueda de la AWS región para la ubicación de una estación terrestre.

AWS Ground Station Métricas y dimensiones

¿Qué métricas están disponibles?

Las siguientes métricas están disponibles en AWS Ground Station.

nota

Las métricas específicas emitidas dependen de las AWS Ground Station capacidades que se utilicen. Según la configuración, es posible que solo se emita un subconjunto de las siguientes métricas.

Métrica Dimensiones de la métrica Description (Descripción)

AzimuthAngle

SatelliteId

El ángulo azimut de la antena. El norte verdadero está a 0 grados y el este a 90 grados.

Unidades: grados

BitErrorRate

Canal, polarización, SatelliteId

Tasa de error en bits en un número determinado de transmisiones de bits. El ruido, la distorsión o las interferencias causan los errores de bits.

Unidades: errores de bits por unidad de tiempo

BlockErrorRate

Canal, polarización, SatelliteId

La tasa de errores de los bloques en un número dado de bloques recibidos. Las interferencias causan los errores de bloque.

Unidades: Bloques erróneos/Número total de bloques

CarrierFrequencyRecovery_Cn0

Categoría, Config, SatelliteId

Relación portadora/densidad de ruido por unidad de ancho de banda.

Unidades: decibelio-hercio (dB-HZ)

CarrierFrequencyRecovery_Locked

Categoría, Config, SatelliteId

Se establece en 1 cuando el bucle de recuperación de frecuencia portadora del desmodulador está bloqueado y en 0 cuando está desbloqueado.

Unidades: sin unidades

CarrierFrequencyRecovery_OffsetFrequency_Hz

Categoría, Config, SatelliteId

El desfase entre el centro estimado de la señal y la frecuencia central ideal. Esto se debe al desplazamiento Doppler y al desfase del oscilador local entre la nave espacial y el sistema de antenas.

Unidades: hercios (Hz)

ElevationAngle

SatelliteId

El ángulo de elevación de la antena. El horizonte está a 0 grados y el cenit a 90 grados.

Unidades: grados

Es/N0

Canal, polarización, SatelliteId

Relación entre la energía por símbolo y la densidad espectral de potencia del ruido.

Unidades: decibelios (dB)

ReceivedPower

Polarización, SatelliteId

La intensidad de la señal medida en el desmodulador/descodificador.

Unidades: decibelios relativos a milivatios (dBm)

SymbolTimingRecovery_ErrorVectorMagnitude

Categoría, Config, SatelliteId

La magnitud del vector de error entre los símbolos recibidos y los puntos de constelación ideales.

Unidades: porcentaje

SymbolTimingRecovery_Locked

Categoría, Config, SatelliteId

Se establece en 1 cuando el bucle de recuperación de temporización de símbolos del desmodulador está bloqueado y en 0 cuando está desbloqueado.

Unidades: sin unidades

SymbolTimingRecovery_OffsetSymbolRate

Categoría, Config, SatelliteId

El desfase entre la tasa de símbolos estimada y la tasa de símbolos de la señal ideal. Esto se debe al desplazamiento Doppler y al desfase del oscilador local entre la nave espacial y el sistema de antenas.

Unidades: Símbolos/segundo

¿Para qué dimensiones se utilizan AWS Ground Station?

Puede filtrar AWS Ground Station los datos mediante las siguientes dimensiones.

Dimensión Description (Descripción)

Category

Demodulación o decodificación.

Channel

Los canales para cada contacto incluyen Uno, Dos, I (en fase) y Q (cuadratura).

Config

Un arn de configuración de decodificación de demodos de enlace descendente de antena.

Polarization

La polarización para cada contacto incluye LHCP (Izquierda Circular Polarizada) o RHCP (Derecha Circular Polarizada).

SatelliteId

El ID del satélite contiene el ARN del satélite para sus contactos.

Visualización de métricas

Al consultar las métricas gráficas, es importante tener en cuenta que la ventana de agregación determina cómo se mostrarán las métricas. Cada métrica de un contacto se puede mostrar como datos por segundo durante tres horas después de la recepción de los datos. CloudWatchMetrics agregará tus datos como datos por minuto una vez transcurrido ese período de 3 horas. Si necesitas ver tus métricas en una medición de datos por segundo, te recomendamos que consultes tus datos dentro del período de 3 horas tras su recepción o que los mantengas fuera de Metrics. CloudWatch Para obtener más información sobre la CloudWatch retención, consulta CloudWatch Conceptos de Amazon: Retención métrica.

Además, los datos capturados en los primeros 60 segundos no contendrán suficiente información para producir métricas significativas y es probable que no se muestren. Para consultar las métricas significativas, se recomienda consultar los datos después de 60 segundos.

Graph showing pass metrics with dBm and error rate lines over time during 11 minutes of a contact.

Para obtener más información sobre cómo graficar AWS Ground Station las métricas CloudWatch, consulte Graficar las métricas.

Para consultar las métricas desde la consola de

  1. Determine la AWS región asociada a la ubicación de su estación terrestre. AWS Ground Station emite CloudWatch métricas en la región asociada a la ubicación de la estación terrestre de tu contacto. Para ver la lista de ubicaciones de las estaciones terrestres y sus AWS regiones asociadas, consulteBúsqueda de la AWS región para la ubicación de una estación terrestre.

  2. Abra la consola de CloudWatch .

  3. En el panel de navegación, seleccione Métricas.

  4. Seleccione el espacio de nombres de GroundStation.

    Interface showing metrics categorized by AWS services used, including a tile for AWS Ground Station, which will appear after metrics have been emitted from the service.

  5. Seleccione las dimensiones métricas que desee (por ejemplo, canal, polarización SatelliteId).

    Metrics interface showing "All metrics" tab with metrics grouped by dimensions, "Channel, Polarization, SatelliteId" and "Polarization, SatelliteId."

  6. La pestaña All metrics muestra todas las métricas para dicha dimensión en el espacio de nombres. Se puede hacer lo siguiente:

    1. Para ordenar la tabla, utilice el encabezado de columna.

    2. Para graficar una métrica, seleccione la casilla de verificación asociada a la métrica. Para seleccionar todas las métricas, seleccione la casilla de verificación situada en la fila de encabezados de la tabla.

    3. Para filtrar por recurso, seleccione el ID de recurso y, a continuación, elija Add to search (Añadir a la búsqueda).

    4. Para filtrar por métrica, elija el nombre de la métrica y, a continuación, seleccione Add to search (Añadir a búsqueda).

Para consultar métricas mediante la AWS CLI

AWS Ground Station emite CloudWatch métricas en la región asociada a la ubicación de la estación terrestre de tu contacto. Para ver la lista de ubicaciones de estaciones terrestres y sus AWS regiones asociadas,Búsqueda de la AWS región para la ubicación de una estación terrestre. ground-station-region-codeSustitúyalo por el código de AWS región de la ubicación de la estación terrestre (us-west-2por ejemplo, en Oregón 1, Hawái 1 o Alaska 1). Todos los AWS CLI comandos siguientes de este procedimiento deben usar la misma región.

  1. Asegúrese de que AWS CLI esté instalado. Para obtener información sobre la instalación AWS CLI, consulte Instalación de la versión 2 de la AWS CLI.

  2. Identifique la AWS región asociada a la ubicación de su estación terrestre.

  3. Utilice el get-metric-datamétodo de la CloudWatch CLI para generar un archivo que se pueda modificar para especificar las métricas que le interesan y, a continuación, se utilice para consultarlas.

    Para ello, ejecute lo siguiente:aws cloudwatch get-metric-data --region ground-station-region-code --generate-cli-skeleton. Esto generará un resultado similar a:

    { "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": "" } }
  4. Enumere las CloudWatch métricas disponibles ejecutándolasaws cloudwatch list-metrics --region ground-station-region-code.

    Si lo has utilizado recientemente AWS Ground Station, el método debería devolver un resultado que contenga entradas como las siguientes:

    ... { "Namespace": "AWS/GroundStation", "MetricName": "ReceivedPower", "Dimensions": [ { "Name": "Polarization", "Value": "LHCP" }, { "Name": "SatelliteId", "Value": "arn:aws:groundstation::111111111111:satellite/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" } ] }, ...
    nota

    Si han pasado más de 2 semanas desde la última vez que lo usaste AWS Ground Station, tendrás que inspeccionar manualmente la tabla de métricas disponibles para encontrar los nombres y las dimensiones de las métricas en el espacio de nombres de las AWS/GroundStation métricas. Para obtener más información sobre CloudWatch las limitaciones, consulta: Ver las métricas disponibles

  5. Modifique el archivo JSON que creó en el paso 2 para que coincida con los valores requeridos del paso 3, por ejemploSatelliteId, y con los Polarization de sus métricas. Asegúrate también de actualizar los StartTime EndTime valores y para que coincidan con tu contacto. Por ejemplo:

    { "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" }
    nota

    AWS Ground Station publica las métricas cada 1 a 60 segundos, según la métrica. Las métricas no se devolverán si el Period campo tiene un valor inferior al período de publicación de la métrica.

  6. Ejecute aws cloudwatch get-metric-data con el archivo de configuración creado en los pasos anteriores. A continuación, se proporciona un ejemplo.

    aws cloudwatch get-metric-data --region ground-station-region-code --cli-input-json file://<nameOfConfigurationFileCreatedInStep2>.json

Las métricas se proporcionarán con marcas de tiempo de su contacto. A continuación se proporciona un ejemplo de salida de métricas de 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": [] }