

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 en utilisant la `get_app_url` fonction comme méthode `estimator` de classe
<a name="debugger-htb-access-tb-get-app-url-estimator-method"></a>

Si vous êtes en train d'exécuter une tâche de formation à l'aide de la `estimator` classe du SDK SageMaker Python et que vous avez un objet actif de cette `estimator` classe, vous pouvez également accéder à la [`get_app_url`fonction en tant que méthode de classe](https://sagemaker.readthedocs.io/en/stable/api/training/estimators.html#sagemaker.estimator.EstimatorBase.get_app_url) de la `estimator` classe. Ouvrez l' TensorBoard application ou récupérez une URL non signée en exécutant la `get_app_url` méthode comme suit. La méthode `get_app_url` de classe extrait le nom de la tâche de formation de l'estimateur et ouvre l' TensorBoard application avec la tâche spécifiée.

**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 Studio Classic](#debugger-htb-access-tb-get-app-url-estimator-method-studio)
+ [Option 2 : pour les environnements autres que Studio Classic](#debugger-htb-access-tb-get-app-url-estimator-method-non-studio)

## Option 1 : pour SageMaker Studio Classic
<a name="debugger-htb-access-tb-get-app-url-estimator-method-studio"></a>

**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()` méthode renvoie dans le navigateur Web par défaut de votre environnement.

```
estimator.get_app_url(
    app_type=SupportedInteractiveAppTypes.TENSORBOARD # Required.
)
```

**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.

```
print(
    estimator.get_app_url(
        app_type=SupportedInteractiveAppTypes.TENSORBOARD, # Required.
        open_in_default_web_browser=False, # Optional. 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-get-app-url-estimator-method-non-studio"></a>

Si vous utilisez des environnements autres que Studio Classic, tels que l'instance SageMaker Notebook et Amazon EC2, et que vous souhaitez générer une URL présignée pour ouvrir l'application, utilisez TensorBoard la méthode suivante avec `get_app_url` les informations de votre domaine et de votre profil utilisateur.

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(
    estimator.get_app_url(
        app_type=SupportedInteractiveAppTypes.TENSORBOARD, # Required
        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
    )
)
```