Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Repeat Snapshots

Visão Geral

Esta página descreve as mensagens JSON exatas que podem ser enviadas para o modelo de consistência de sincronização de saúde do Repeat Snapshots.

Propriedade JSON: "saúde"

A saúde pode ser enviada para a API do SUSE Observability Receiver usando a propriedade "health" do objeto JSON comum.

  • Exemplo de saúde repeat_snapshots JSON

{
   "apiKey":"<STACKSTATE_RECEIVER_API_KEY>",
   "collection_timestamp":1585818978,
   "internalHostname":"lnx-343242.srv.stackstate.com",
   "health":[
      {
        "consistency_model": "REPEAT_SNAPSHOTS",
        "start_snapshot": {
          "repeat_interval_s": 50
          //"expiry_interval_s": 200 Optional
        },
        "stop_snapshot": {},
        "stream": {
          "urn": "urn:health:sourceId:streamId"
          //"sub_stream_id": "subStreamId" Optional
        },
        "check_states": [
          {
            "checkStateId": "checkStateId1",
            "message": "Server Running out of disk space",
            "health": "Deviating",
            "topologyElementIdentifier": "server-1",
            "name": "Disk Usage"
          },
          {
            "checkStateId": "checkStateId2",
            "message": "Provisioning failed. [Learn more](https://www.any-link.com)",
            "health": "critical",
            "topologyElementIdentifier": "server-2",
            "name": "Health monitor"
          }
        ]
      }
   ]
}

Cada carga de dados de saúde do Repeat Snapshots possui os seguintes detalhes:

  • start_snapshot - Optional. Um início de um instantâneo precisa ser processado antes de processar check_states. Isso permite que o SUSE Observability compare um instantâneo de stream com o anteriormente recebido e exclua estados de verificação que não estão mais presentes no instantâneo. Ele carrega os seguintes campos como metadados do instantâneo:

    • repeat_interval_s - Tempo em segundos. A frequência com que a fonte externa enviará dados de saúde para o SUSE Observability. O valor máximo permitido é 1800 (30 minutos).

    • expiry_interval_s - Tempo em segundos. O tempo a esperar após a última atualização antes que uma verificação externa seja excluída pelo SUSE Observability. Necessário ao usar subfluxos.

  • stop_snapshot - Opcional. Um fim de um instantâneo será processado após processar os check_states.

  • stream - Objeto que fornece identificação sobre quais instantâneos e check_states pertencem juntos. Ela contém os seguintes campos:

    • urn - Fonte de dados e ID do stream codificados como um URN do SUSE Observability que segue a seguinte convenção: urn:health:<sourceId>:<streamId> onde <sourceId> é o nome da fonte de dados externa e <streamId> é um identificador único para o stream de dados de saúde.

    • sub_stream_id - Optional. Identificador para um subconjunto dos dados de saúde do stream. Quando os dados do stream são distribuídos e reportados por vários Agentes, isso permite os ciclos de vida do Repeat Snapshots por sub_stream_id.

  • check_states - Uma lista de estados de verificação. Cada estado de verificação pode ter os seguintes campos:

    • checkStateId - Identificador para o estado de verificação no sistema externo.

    • message - Opcional. Mensagem a ser exibida na interface do SUSE Observability. Os dados serão interpretados como markdown, permitindo ter links para o sistema externo de verificação que gerou o estado de verificação externo.

    • health - Um dos seguintes valores de estado de saúde do SUSE Observability: Clear, Deviating, Critical.

    • topologyElementIdentifier - Usado para vincular o estado de verificação a um elemento de topologia do SUSE Observability.

    • name - Nome do estado de verificação externo.

Enviar saúde para o SUSE Observability

A saúde pode ser enviada em uma mensagem JSON via HTTP POST. No exemplo abaixo, um instantâneo contendo dois estados de verificação é enviado para o SUSE Observability a partir de um único sistema de monitoramento externo.

curl -X POST \
 '<STACKSTATE_RECEIVER_API_ADDRESS>' \
 -H 'Content-Type: application/json' \
 -d '{
  "collection_timestamp": 1548857167,
  "internalHostname": "local.test",
  "health": [
    {
      "consistency_model": "REPEAT_SNAPSHOTS",
      "start_snapshot": {
        "repeat_interval_s": 300
      },
      "stop_snapshot": {},
      "stream": {
        "urn": "urn:health:sourceId:streamId"
      },
      "check_states": [
        {
          "checkStateId": "checkStateId1",
          "message": "Server Running out of disk space",
          "health": "Deviating",
          "topologyElementIdentifier": "server-1",
          "name": "Disk Usage"
        },
        {
          "checkStateId": "checkStateId2",
          "message": "Provisioning failed. [Learn more](https://www.any-link.com)",
          "health": "critical",
          "topologyElementIdentifier": "server-2",
          "name": "Health monitor"
        }
      ]
    }
  ]
}'