View a markdown version of this page

Enregistrement des annotations, des métadonnées et des ID utilisateur - AWS X-Ray

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Enregistrement des annotations, des métadonnées et des ID utilisateur

Note

X-Ray SDK/Daemon Avis de maintenance — Le 25 février 2026, ils AWS X-Ray SDKs/Daemon passeront en mode maintenance, où les versions du X-Ray SDK et de Daemon AWS seront limitées uniquement pour résoudre les problèmes de sécurité. Pour plus d'informations sur le calendrier de support, consultezChronologie du support pour le SDK et Daemon X-Ray. Nous vous recommandons de migrer vers OpenTelemetry. Pour plus d'informations sur la migration vers OpenTelemetry, consultez la section Migration de l' X-Ray instrumentation vers OpenTelemetry l'instrumentation.

Dans la classe de modèle de jeu, l'application enregistre les Game objets dans un bloc de métadonnées chaque fois qu'elle enregistre un jeu dans DynamoDB. L'application enregistre séparément les ID de jeu dans les annotations en vue d'une utilisation avec les expressions de filtre.

Exemple src/main/java/scorekeep/GameModel.java — Annotations et métadonnées
import com.amazonaws.xray.AWSXRay;
import com.amazonaws.xray.entities.Segment;
import com.amazonaws.xray.entities.Subsegment;
...
  public void saveGame(Game game) throws SessionNotFoundException {
    // wrap in subsegment
    Subsegment subsegment = AWSXRay.beginSubsegment("## GameModel.saveGame");
    try {
      // check session
      String sessionId = game.getSession();
      if (sessionModel.loadSession(sessionId) == null ) {
        throw new SessionNotFoundException(sessionId);
      }
      Segment segment = AWSXRay.getCurrentSegment();
      subsegment.putMetadata("resources", "game", game);
      segment.putAnnotation("gameid", game.getId());
      mapper.save(game);
    } catch (Exception e) {
      subsegment.addException(e);
      throw e;
    } finally {
      AWSXRay.endSubsegment();
    }
  }

Dans le contrôleur de déplacement, l'application enregistre les ID utilisateur avec setUser. Les ID utilisateur sont enregistrés dans un champ distinct des segments et indexés en vue d'une utilisation avec la recherche.

Exemple src/main/java/scorekeep/MoveController.java — ID utilisateur
import com.amazonaws.xray.AWSXRay;
...
  @RequestMapping(value="/{userId}", method=RequestMethod.POST)
  public Move newMove(@PathVariable String sessionId, @PathVariable String gameId, @PathVariable String userId, @RequestBody String move) throws SessionNotFoundException, GameNotFoundException, StateNotFoundException, RulesException {
    AWSXRay.getCurrentSegment().setUser(userId);
    return moveFactory.newMove(sessionId, gameId, userId, move);
  }