Automatização com eventos AWS Ground Station

nota

Este documento usa o termo “evento” por toda parte. CloudWatch Eventos e EventBridge são o mesmo serviço subjacente API e. Regras para corresponder a eventos de entrada e roteá-los para destinos para processamento podem ser construídas usando qualquer um dos serviços.

Os eventos permitem que você automatize seus AWS serviços e responda automaticamente aos eventos do sistema, como problemas de disponibilidade de aplicativos ou alterações de recursos. Os eventos dos AWS serviços são entregues quase em tempo real. Você pode escrever regras simples para indicar quais eventos são do seu interesse, e as ações automatizadas a serem tomadas quando um evento corresponder à regra. Algumas das ações que podem ser acionadas automaticamente incluem o seguinte:

• Invocando uma função AWS Lambda

• Invocando o EC2 comando Amazon Run

• Transmitir o evento Amazon Kinesis Data Streams

• Ativando uma máquina de AWS Step Functions estado

• Notificar um SNS tópico da Amazon ou uma fila da Amazon SQS

Alguns exemplos de uso de eventos com AWS Ground Station incluem:

• Invocar uma função Lambda para automatizar o início e a interrupção de instâncias da EC2 Amazon com base no estado do evento.

• Publicar em um SNS tópico da Amazon sempre que um contato muda de estado. Esses tópicos podem ser configurados para enviar avisos por e-mail no início ou no final dos contatos.

Para obter mais informações, consulte o Guia do usuário do Amazon EventBridge Events.

AWS Ground Station Tipos de eventos

nota

Todos os eventos gerados pela AWS Ground Station têm “aws.groundstation” como valor para “source”.

AWS Ground Station emite eventos relacionados a mudanças de estado para apoiar sua capacidade de personalizar sua automação. Atualmente, AWS Ground Station oferece suporte a eventos de mudança de estado de contato, eventos de alteração de grupos de endpoints de fluxo de dados e eventos de mudança de estado de efemérides. As seções a seguir fornecem informações detalhadas sobre cada tipo.

Cronograma do evento de contato

AWS Ground Station emite eventos quando seu contato muda de estado. Para obter mais informações sobre quais são essas mudanças de estado e o que os próprios estados significam, consulteCiclo de vida do contato. Todos os grupos de endpoints de fluxo de dados usados em seu contato têm um conjunto independente de eventos que também são emitidos. Durante esse mesmo período, também emitimos eventos para seu grupo de endpoints de fluxo de dados. O horário exato dos eventos de pré-passagem e pós-passagem pode ser configurado por você à medida que configura o perfil da missão e o grupo de endpoints do fluxo de dados.

O diagrama a seguir mostra os status e os eventos emitidos por um contato nominal e seu grupo de endpoints de fluxo de dados associado.

Alteração de estado do contato do Ground Station

Se você quiser realizar uma ação específica quando um contato futuro estiver mudando de estado, você pode configurar uma regra para automatizar essa ação. Isso é útil quando quiser receber notificações sobre as alterações de estado do contato. Se você quiser mudar quando receber esses eventos, você pode modificar o perfil da sua missão contactPrePassDurationSeconds contactPostPassDurationSecondse. Os eventos são enviados para a região na qual o contato foi agendado.

Um exemplo de evento é fornecido abaixo.

{
    "version": "0",
    "id": "01234567-0123-0123",
    "account": "123456789012",
    "time": "2019-05-30T17:40:30Z",
    "region": "us-west-2",
    "source": "aws.groundstation",
    "resources": [
        "arn:aws:groundstation:us-west-2:123456789012:contact/11111111-1111-1111-1111-111111111111"
    ],
    "detailType": "Ground Station Contact State Change",
    "detail": {
        "contactId": "11111111-1111-1111-1111-111111111111",
        "groundstationId": "Ground Station 1",
        "missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/11111111-1111-1111-1111-111111111111",
        "satelliteArn": "arn:aws:groundstation::123456789012:satellite/11111111-1111-1111-1111-111111111111",
        "contactStatus": "PASS"
    },
    "account": "123456789012"
}

Os possíveis valores para contactStatus são definidos em AWS Ground Station status de contato.

Alteração de estado do grupo de endpoints do fluxo de dados do Ground Station

Se você quiser executar uma ação quando seu grupo de endpoints de fluxo de dados está sendo usado para receber dados, pode configurar uma regra para automatizar essa ação. Isso permitirá executar ações diferentes em resposta à alteração de estados do status do grupo de endpoints do fluxo de dados. Se você quiser alterar a data de recebimento desses eventos, use um grupo de endpoints de fluxo de dados com diferentes e. contactPrePassDurationSecondscontactPostPassDurationSeconds Esse evento será enviado para a região do grupo de endpoints do fluxo de dados.

Um exemplo é fornecido abaixo.

{
    "version": "0",
    "id": "01234567-0123-0123",
    "account": "123456789012",
    "time": "2019-05-30T17:40:30Z",
    "region": "us-west-2",
    "source": "aws.groundstation",
    "resources": [
        "arn:aws:groundstation:us-west-2:123456789012:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
        "arn:aws:groundstation:us-west-2:123456789012:contact/98ddd10f-f2bc-479c-bf7d-55644737fb09",
        "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234"
    ],
    "detailType": "Ground Station Dataflow Endpoint Group State Change",
    "detail": {
        "dataflowEndpointGroupId": "bad957a8-1d60-4c45-a92a-39febd98921d",
        "groundstationId": "Ground Station 1",
        "contactId": "98ddd10f-f2bc-479c-bf7d-55644737fb09",
        "dataflowEndpointGroupArn": "arn:aws:groundstation:us-west-2:680367718957:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
        "missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234",
        "dataflowEndpointGroupState": "PREPASS"
    },
    "account": "123456789012"
}

Os possíveis estados do dataflowEndpointGroupState incluem PREPASS, PASS, POSTPASS e COMPLETED.

Eventos de efemérides

Mudança de estado da efeméride Ground Station

Se você quiser executar uma ação específica quando uma efeméride estiver mudando de estado, é possível configurar uma regra para automatizar essa ação. Isso permite que você execute ações diferentes em resposta à mudança de estado de uma efeméride. Por exemplo, você pode realizar uma ação quando uma efeméride tiver concluído a validação, e agora está ENABLED. A notificação desse evento será enviada para a região onde a efeméride foi enviada.

Um exemplo é fornecido abaixo.

    {
    "id": "7bf73129-1428-4cd3-a780-95db273d1602",
    "detail-type": "Ground Station Ephemeris State Change",
    "source": "aws.groundstation",
    "account": "123456789012",
    "time": "2019-12-03T21:29:54Z",
    "region": "us-west-2",
    "resources": [
    "arn:aws:groundstation::123456789012:satellite/10313191-c9d9-4ecb-a5f2-bc55cab050ec",
    "arn:aws:groundstation::123456789012:ephemeris/111111-cccc-bbbb-a555-bcccca005000",
    ],
    "detail": {
    "ephemerisStatus": "ENABLED",
    "ephemerisId": "111111-cccc-bbbb-a555-bcccca005000",
    "satelliteId": "10313191-c9d9-4ecb-a5f2-bc55cab050ec"
    }
    }
   

Os possíveis estados do ephemerisStatus incluem ENABLED, VALIDATING, INVALID ERROR, DISABLED e EXPIRED