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.

# Ouvrez TensorBoard à l'aide du `sagemaker.interactive_apps.tensorboard` module
<a name="debugger-htb-access-tb-url"></a>

Le `sagemaker.interactive_apps.tensorboard` module fournit une fonction appelée `get_app_url` qui génère des URL non signées ou présignées pour ouvrir l' TensorBoard application dans n'importe quel environnement dans SageMaker AI ou Amazon EC2. Cela permet de fournir une expérience unifiée aux utilisateurs et aux non-utilisateurs de Studio Classic. Pour l'environnement Studio, vous pouvez ouvrir TensorBoard en exécutant la `get_app_url()` fonction telle quelle, ou vous pouvez également spécifier un nom de tâche pour démarrer le suivi à l'ouverture de l' TensorBoard application. Pour les environnements autres que Studio Classic, vous pouvez ouvrir TensorBoard en fournissant les informations de votre domaine et de profil utilisateur à la fonction utilitaire. Grâce à cette fonctionnalité, quel que soit l'endroit ou la manière dont vous exécutez le code d'entraînement et lancez les tâches de formation, vous pouvez y accéder directement en TensorBoard exécutant la `get_app_url` fonction dans votre bloc-notes ou votre terminal Jupyter.

**Note**  
Cette fonctionnalité est disponible dans le SDK SageMaker Python v2.184.0 et versions ultérieures. Pour utiliser cette fonctionnalité, assurez-vous de mettre à niveau le kit SDK en exécutant `pip install sagemaker --upgrade`.

**Topics**
+ [Option 1 : pour SageMaker AI Studio Classic](#debugger-htb-access-tb-url-unsigned)
+ [Option 2 : pour les environnements autres que Studio Classic](#debugger-htb-access-tb-url-presigned)

## Option 1 : pour SageMaker AI Studio Classic
<a name="debugger-htb-access-tb-url-unsigned"></a>

Si vous utilisez SageMaker Studio Classic, vous pouvez ouvrir directement l' TensorBoardapplication ou récupérer une URL non signée en exécutant la `get_app_url` fonction comme suit. Comme vous êtes déjà dans l’environnement Studio Classic et que vous êtes connecté en tant qu’utilisateur de domaine, `get_app_url()` génère une URL non signée, car il n’est pas nécessaire de vous authentifier à nouveau. 

**Pour ouvrir l' TensorBoard application** 

Le code suivant ouvre automatiquement l' TensorBoard application à partir de l'URL non signée que la `get_app_url()` fonction renvoie dans le navigateur Web par défaut de votre environnement.

```
from sagemaker.interactive_apps import tensorboard

region = "us-west-2"
app = tensorboard.TensorBoardApp(region)

app.get_app_url(
    training_job_name="your-training_job_name" # Optional. Specify the job name to track a specific training job 
)
```

**Pour récupérer une URL non signée et ouvrir l' TensorBoardapplication manuellement**

Le code suivant imprime une URL non signée que vous pouvez copier dans un navigateur Web et ouvrir l' TensorBoard application.

```
from sagemaker.interactive_apps import tensorboard

region = "us-west-2"
app = tensorboard.TensorBoardApp(region)
print("Navigate to the following URL:")
print(
    app.get_app_url(
        training_job_name="your-training_job_name", # Optional. Specify the name of the job to track.
        open_in_default_web_browser=False           # Set to False to print the URL to terminal.
    )
)
```

Notez que si vous exécutez les deux exemples de code précédents en dehors de l'environnement SageMaker AI Studio Classic, la fonction renverra une URL vers la page TensorBoard d'accueil de la console SageMaker AI, car ces derniers ne contiennent aucune information de connexion à votre domaine et à votre profil utilisateur. Pour créer une URL présignée, consultez l’option 2 dans la section suivante.

## Option 2 : pour les environnements autres que Studio Classic
<a name="debugger-htb-access-tb-url-presigned"></a>

Si vous utilisez des environnements autres que Studio Classic, tels qu'une instance SageMaker Notebook ou Amazon EC2, et que vous souhaitez TensorBoard ouvrir directement depuis l'environnement dans lequel vous vous trouvez, vous devez générer une URL présignée avec votre domaine et les informations de votre profil utilisateur. Une URL *présignée* est une URL qui est connectée à Amazon SageMaker Studio Classic lors de la création de l'URL avec votre domaine et votre profil utilisateur, et qui donne donc accès à toutes les applications de domaine et à tous les fichiers associés à votre domaine. Pour ouvrir TensorBoard via une URL présignée, utilisez la `get_app_url` fonction avec le nom de votre domaine et de votre profil utilisateur comme suit.

Notez que cette option nécessite que l’utilisateur de domaine dispose de l’autorisation `sagemaker:CreatePresignedDomainUrl`. Sans autorisation, l’utilisateur de domaine recevra une erreur d’exception.

**Important**  
Ne partagez aucun document présigné URLs. La `get_app_url` fonction crée une signature présignée URLs, qui s'authentifie automatiquement auprès de votre domaine et de votre profil utilisateur et donne accès à toutes les applications et à tous les fichiers associés à votre domaine.

```
print(
    app.get_app_url(
        training_job_name="your-training_job_name", # Optional. Specify the name of the job to track.
        create_presigned_domain_url=True,           # Reguired to be set to True for creating a presigned URL.
        domain_id="your-domain-id",                 # Required if creating a presigned URL (create_presigned_domain_url=True).
        user_profile_name="your-user-profile-name", # Required if creating a presigned URL (create_presigned_domain_url=True).
        open_in_default_web_browser=False,          # Optional. Set to False to print the URL to terminal.
        optional_create_presigned_url_kwargs={}     # Optional. Add any additional args for Boto3 create_presigned_domain_url
    )
)
```

**Astuce**  
La `get_app_url` fonction exécute l'[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/create_presigned_domain_url.html](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/create_presigned_domain_url.html)API AWS SDK pour Python (Boto3) dans le backend. Comme l'`create_presigned_domain_url`API Boto3 crée un domaine présigné URLs qui expire dans 300 secondes par défaut, les TensorBoard applications présignées expirent URLs également dans 300 secondes. Si vous souhaitez prolonger le délai d’expiration, transmettez l’argument `ExpiresInSeconds` à l’argument `optional_create_presigned_url_kwargs` de la fonction `get_app_url` comme suit.  

```
optional_create_presigned_url_kwargs={"ExpiresInSeconds": 1500}
```

**Note**  
Si l'une de vos entrées passées aux arguments de n'`get_app_url`est pas valide, la fonction affiche une URL vers la page de TensorBoard destination au lieu d'ouvrir l' TensorBoard application. Le message de sortie ressemblerait à ce qui suit.  

```
Navigate to the following URL:
https://us-west-2.console.aws.amazon.com/sagemaker/home?region=us-west-2#/tensor-board-landing
```