classe ara::phm::SupervisedEntity

A classe de modelo (template) ara::phm::SupervisedEntity destina-se ao monitoramento funcional no Platform Health Management e permite que as aplicações relatem checkpoints definidos [SWS_PHM_01127]. A instância está vinculada a um InstanceSpecifier, é movível, mas não copiável [SWS_PHM_01123], [SWS_PHM_01212]. Enquanto ReportCheckpoint() é thread-safe, a ativação assíncrona via Enable(), a desativação via Disable() e o destrutor não são thread-safe [SWS_PHM_01130], [SWS_PHM_01211].

mais ›

Contexto

A classe de modelo (template) ara::phm::SupervisedEntity representa uma unidade funcional a ser monitorada no Platform Health Management (PHM) do AUTOSAR Adaptive [SWS_PHM_01123]. Ela serve a uma aplicação como interface para relatar o alcance de pontos de controle (checkpoints) definidos ao PHM [SWS_PHM_01127]. Com base nos checkpoints relatados, o subsistema do PHM monitora o comportamento temporal e lógico da entidade. A atribuição à arquitetura e aos elementos de modelagem correspondentes ocorre por meio de um ara::core::InstanceSpecifier, que aponta para uma porta correspondente [SWS_PHM_01123]. Além disso, a classe permite que a aplicação ative ou desative seletivamente o monitoramento conforme necessário [SWS_PHM_01130], [SWS_PHM_01380].

Ciclo de vida

Um objeto do tipo ara::phm::SupervisedEntity é explicitamente instanciado informando um ara::core::InstanceSpecifier [SWS_PHM_01123]. A classe implementa uma semântica de movimento: o construtor de movimento [SWS_PHM_01214] e o operador de atribuição por movimento [SWS_PHM_01215] transferem o recurso e são especificados como thread-safe e seguros contra exceções. O construtor de cópia [SWS_PHM_01212] e o operador de atribuição por cópia [SWS_PHM_01213] foram excluídos (delete), de modo que as instâncias permaneçam vinculadas ao seu proprietário. O destrutor ~SupervisedEntity() libera a entidade e é declarado como não thread-safe [SWS_PHM_01211]; a destruição deve, portanto, ocorrer de forma sincronizada se múltiplas threads estiverem envolvidas.

Após a criação, a supervisão pode ser ativada por meio de Enable() [SWS_PHM_01130] ou suspensa por meio de Disable() [SWS_PHM_01380]. Ambas as funções de controle retornam um ara::core::Future<void> e não são thread-safe, enquanto o reporte regular de checkpoints por meio de ReportCheckpoint() pode ser executado de forma thread-safe [SWS_PHM_01127].

Caminho de utilização

A interação típica divide-se em inicialização, ativação opcional da supervisão, reporte cíclico ou baseado em eventos de checkpoints, bem como a liberação da instância. O diagrama de sequência a seguir ilustra esse fluxo:

Diagrama de sequência: fluxo típico de instanciação, ativação, reporte de checkpoints e desativação de uma SupervisedEntity. Fontes: [SWS_PHM_01123], [SWS_PHM_01130], [SWS_PHM_01127], [SWS_PHM_01380], [SWS_PHM_01211]

Inicialmente, a aplicação instancia o objeto com o InstanceSpecifier configurado [SWS_PHM_01123]. Se a supervisão dever ser ativada (dependendo do estado do grupo de funções), a aplicação chama Enable() e se sincroniza, se necessário, por meio do ara::core::Future<void> retornado [SWS_PHM_01130]. Durante a execução, a aplicação reporta pontos de controle atingidos por meio de ReportCheckpoint(checkpointId) [SWS_PHM_01127]. Antes do encerramento ou em transições de estado funcional, a supervisão pode ser suspensa por meio de Disable() [SWS_PHM_01380], antes de a instância ser finalmente destruída [SWS_PHM_01211].

Cenários de erro

Condições de erro são sinalizadas em ara::phm::SupervisedEntity primariamente por meio de códigos de erro assíncronos em valores de retorno, bem como por violações de sistema (violations) reportadas:

• Erro de tempo de execução no controle de estado: se um chamador tentar chamar Enable() [SWS_PHM_01130] ou Disable() [SWS_PHM_01380] enquanto uma solicitação de ativação ou desativação já estiver em andamento, a chamada falha. O ara::core::Future resultante reporta, nesse caso, o código de erro PhmErrc::kServiceNotReady (semântica de rollback).
• Violações de construção: na chamada do construtor [SWS_PHM_01123], pré-condições estritas são verificadas:
  • AraNotInitializedViolation: o ambiente de tempo de execução ARA ainda não está inicializado.
  • InstanceSpecifierMappingIntegrityViolation: O identificador não pode ser resolvido no contexto do executável ou não aponta para um PortPrototype.
  • PortInterfaceMappingViolation: o PortPrototype tipado com PhmSupervisedEntityInterface não é referenciado por nenhum SupervisionCheckpoint.
  • ProcessMappingViolation: o processo chamador não está autorizado no modelo para os respectivos pontos de controle.
  • InstanceSpecifierAlreadyInUseViolation: o identificador já está sendo usado por outra instância no mesmo processo.
• Violação no reporte de checkpoint: se ReportCheckpoint() for chamado por um processo que não está associado no modelo por meio de SupervisionCheckpoint.process, isso resulta em uma InsufficientPermissionsViolation [SWS_PHM_01127].