Ativando notificações de eventos para IBM® Storage Ceph® as a Service

Como administrador do IBM® Storage Ceph® as a Service, talvez você queira enviar notificações sobre eventos no IBM Storage Ceph as a Service a outros usuários ou destinatários humanos, por meio de e-mail, SMS ou outros canais de entrega compatíveis. Além disso, você pode desejar enviar essas notificações de eventos para outros aplicativos para construir a lógica usando programação orientada a eventos, por meio de webhooks, por exemplo. Isso é possível graças à integração entre IBM® Storage Ceph® as a Service, IBM Cloud e Event Notifications.

Para enviar informações para Event Notifications, você deve conectar sua instância do IBM Storage Ceph as a Service ao Event Notifications. Para obter mais informações sobre como trabalhar com o Event Notifications, consulte “Introdução ao Event Notifications ”.

Como os eventos são coletados e enviados por IBM® Storage Ceph® as a Service

Quando ocorre um evento de interesse na sua instância do IBM Storage Ceph as a Service, o IBM Storage Ceph as a Service se comunica com uma instância conectada do Event Notifications para encaminhar uma notificação a um destino compatível.

Eventos para o IBM® Storage Ceph® as a Service

A tabela a seguir lista os eventos do IBM Storage Ceph as a Service.

Ações que geram notificações de eventos
Nome do evento Tipo de evento Nome do subtipo Subtipo Gravidade
IBM Storage Ceph Capacidade de armazenamento do serviço com.ibm.cloud.software-defined-storage.capacity Armazenamento em bloco alocado a 50% da capacidade block_capacity_50_percent baixo
Armazenamento em bloco alocado a 80% da capacidade block_capacity_80_percent medium
Armazenamento em bloco alocado a 100% da capacidade block_capacity_100_percent high
Armazenamento de objetos alocado a 50% da capacidade object_capacity_50_percent baixo
Armazenamento de objetos alocado a 80% da capacidade object_capacity_80_percent medium
Armazenamento de objetos alocado a 100% da capacidade object_capacity_100_percent high
IBM Storage Ceph Certificados “ S3 ” como serviço com.ibm.cloud.software-defined-storage.s3-certificate S3 o certificado expirou s3_cert_expired high
S3 O certificado vai expirar em 1 dia s3_cert_expire_1_day high
S3 O certificado vai expirar em 10 dias s3_cert_expire_10_day high
S3 O certificado vai expirar em 30 dias s3_cert_expire_30_day medium
S3 O certificado expirará em 60 dias s3_cert_expire_60_day medium
S3 O certificado expirará em 90 dias s3_cert_expire_90_day baixo

Ativando notificações

Os eventos gerados por uma instância do serviço “ IBM Storage Ceph ” podem ser encaminhados para uma instância do serviço “ Event Notifications ” disponível na mesma conta. É possível configurar apenas uma instância do IBM Storage Ceph as a Service para cada instância do serviço Event Notifications.

Conectando-se ao Event Notifications no console

Antes de ativar as notificações para o “ IBM Storage Ceph ” como serviço, certifique-se de que você tenha uma instância do serviço “ Event Notifications ” na mesma conta que a sua instância do “ IBM Storage Ceph ” como serviço. Em seguida, você pode usar a seção “Configurações > Event Notifications ” na interface do usuário do “ IBM Storage Ceph as a Service” para conectar os serviços.

  1. No console, clique no ícone “ Menu de navegação ” Ícone do menu de navegação > Lista de recursos.

  2. Selecione sua instância do “ IBM Storage Ceph ” como serviço.

  3. Na navegação do IBM Storage Ceph as a Service, clique em Configurações.

  4. Na seção Event Notifications, clique em Conectar.

  5. Verifique os detalhes de origem da conexão. Opcionalmente, forneça uma descrição.

  6. Selecione o grupo de recursos e a instância do serviço “ Event Notifications ” à qual deseja se conectar.

    Se não houver uma autorização IAM entre o IBM Storage Ceph as a Service e o Event Notifications na sua conta, será exibida uma caixa de diálogo. Siga os prompts para conceder acesso entre os serviços.

    1. Para conceder acesso entre o IBM Storage Ceph como Serviço e o Event Notifications, clique em Autorizar.
    2. Selecione Event Notifications como serviço de destino.
    3. Na lista de instâncias, selecione a instância do serviço “ Event Notifications ” que você deseja autorizar.
    4. Selecione a função Gerente de origem de eventos.
    5. Clique em Revisar.
    6. Clique em Designar.

  7. Para confirmar a conexão, clique em Conectar.

Entregando notificações para destinos selecionados

Depois de ativar as notificações para o “ IBM Storage Ceph ” como serviço, crie tópicos e assinaturas em Event Notifications para que os alertas possam ser encaminhados e entregues aos destinos selecionados.

Para obter uma lista completa dos destinos compatíveis, consulte a documentação do Event Notifications.

Notificações por e-mail

Você pode usar o serviço de e-mail IBM Cloud como canal de envio das notificações de eventos do IBM Storage Ceph como Serviço. Crie uma assinatura do Event Notifications entre um tópico existente e o serviço de e-mail IBM Cloud para encaminhar seus alertas a vários destinatários por e-mail.

Um e-mail enviado por IBM Cloud contendo informações sobre o evento “ IBM Storage Ceph ” como serviço se assemelha ao exemplo a seguir:

Subject: Replace S3 certificate (expires in 90 days)
Body: S3 certificate will expire in 90 days. Please replace your S3 certificate.

Para receber informações detalhadas sobre uma notificação de evento por e-mail, selecione a opção “Adicionar carga útil da notificação” ao criar uma assinatura do Event Notifications. Seu e-mail exibe os detalhes da carga útil de notificação que estão associados ao evento.

Webhooks

É possível configurar um destino de webhook para que uma notificação recebida possa ser consumida programaticamente por um app ou serviço. Para obter mais informações sobre como configurar webhooks, consulte a documentação do Event Notifications.

Detalhes da carga útil de notificação

Os eventos bem-sucedidos gerados pelo serviço “ IBM Storage Ceph ” contêm vários campos que ajudam a identificar a origem e os detalhes de um evento.

As notificações de eventos do “ IBM Storage Ceph ” como serviço contêm apenas propriedades de metadados, como nomes ou identificadores de recursos. Os dados sensíveis, por exemplo, chaves de API ou senhas, não são incluídos nos eventos gerados.

As propriedades enviadas para Event Notifications variam de acordo com o tipo de evento. Por exemplo, se ocorrer um evento de expiração do certificado S3, o serviço “ IBM Storage Ceph ” envia uma notificação para Event Notifications semelhante ao exemplo a seguir.

{
    "ibmendefaultlong": "S3 certificate will expire in 90 days. Please replace your S3 certificate.",
    "ibmendefaultshort": "Replace S3 certificate (expires 90 days)",
    "ibmenseverity": "low",
    "ibmensourceid": "crn:v1:staging:public:software-defined-storage:satloc_dal_crmid4v20tl6u8usf790:a/3faf73b8d12b47fa6ce87494f8ae7686:0c81f602-5142-4809-9e42-31de8453416a::",
    "id": "38eb4721-db9b-4ba6-a5e7-cdd9cce66763",
    "source": "crn:v1:staging:public:software-defined-storage:satloc_dal_crmid4v20tl6u8usf790:a/3faf73b8d12b47fa6ce87494f8ae7686:0c81f602-5142-4809-9e42-31de8453416a::",
    "specversion": "1.0",
    "time": "2025-04-23T21:13:44.301Z",
    "type": "com.ibm.cloud.software-defined-storage.s3-certificate:s3_cert_expire_90_day"
}

Consulte a tabela a seguir para obter mais informações sobre as propriedades de notificação de eventos.

Propriedades na carga útil de uma notificação de evento
Propriedade Descrição
ibmendefaultlong Esta mensagem é utilizada no caso de um evento ser encaminhado para um destino que exija um texto legível por humanos, mas em que não tenha sido especificado um atributo específico para esse destino.
ibmendefaultshort Esta mensagem é utilizada no caso de um evento ser encaminhado para um destino que exija um texto legível por humanos, mas em que não tenha sido especificado um atributo específico para esse destino.
ibmenseverity A gravidade do evento.
ibmensourceid Este é o ID da fonte criada em Event Notifications. Essa opção está disponível na interface do usuário do Event Notifications, na seção “Fontes”.
id Um identificador único que identifica cada evento.
source Este é o identificador do produtor do evento (ou seja, o CRN do serviço “ IBM Storage Ceph ”).
specversion Essa é a versão da especificação Cloud Events que o Event Notifications suporta atualmente. Esse valor deve ser definido como “ 1.0 ”.
time Carimbo de data e hora em UTC em que o evento ocorreu. Deve estar no formato RFC 3339.
type Isso descreve o tipo de evento. Tem a forma <event-type-name>:<sub-type>.