

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `Abra TensorBoard usando a função get_app_url como um método de classe estimadora`
<a name="debugger-htb-access-tb-get-app-url-estimator-method"></a>

Se você estiver executando um trabalho de treinamento usando a `estimator` classe do SDK do SageMaker Python e tiver um objeto ativo da `estimator` classe, também poderá acessar a [`get_app_url`função como um método de classe da classe](https://sagemaker.readthedocs.io/en/stable/api/training/estimators.html#sagemaker.estimator.EstimatorBase.get_app_url). `estimator` Abra o TensorBoard aplicativo ou recupere um URL não assinado executando o `get_app_url` método da seguinte maneira. O método de `get_app_url` classe extrai o nome do trabalho de treinamento do estimador e abre o TensorBoard aplicativo com o trabalho especificado.

**nota**  
Essa funcionalidade está disponível no SageMaker Python SDK v2.184.0 e versões posteriores. Para usar essa funcionalidade, certifique-se de atualizar o SDK executando `pip install sagemaker --upgrade`.

**Topics**
+ [Opção 1: Para SageMaker Studio Classic](#debugger-htb-access-tb-get-app-url-estimator-method-studio)
+ [Opção 2: para ambientes que não sejam do Studio Classic](#debugger-htb-access-tb-get-app-url-estimator-method-non-studio)

## Opção 1: Para SageMaker Studio Classic
<a name="debugger-htb-access-tb-get-app-url-estimator-method-studio"></a>

**Para abrir o TensorBoard aplicativo** 

O código a seguir abre automaticamente o TensorBoard aplicativo a partir da URL não assinada que o `get_app_url()` método retorna no navegador da Web padrão do seu ambiente.

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

**Para recuperar um URL não assinado e abrir o aplicativo manualmente TensorBoard**

O código a seguir imprime uma URL não assinada que você pode copiar para um navegador da Web e abrir o TensorBoard aplicativo.

```
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.
    )
)
```

Observe que, se você executar as duas amostras de código anteriores fora do ambiente do SageMaker AI Studio Classic, a função retornará uma URL para a página TensorBoard inicial no console do SageMaker AI, porque elas não têm informações de login no seu domínio e perfil de usuário. Para criar um URL pré-assinado, consulte a Opção 2 na seção a seguir.

## Opção 2: para ambientes que não sejam do Studio Classic
<a name="debugger-htb-access-tb-get-app-url-estimator-method-non-studio"></a>

Se você usa ambientes que não são do Studio Classic, como a instância do SageMaker Notebook e o Amazon EC2, e deseja gerar uma URL pré-assinada para abrir TensorBoard o aplicativo, use `get_app_url` o método com suas informações de domínio e perfil de usuário da seguinte forma.

Observe que essa opção exige que o usuário do domínio tenha a permissão `sagemaker:CreatePresignedDomainUrl`. Sem a permissão, o usuário do domínio receberá um erro de exceção.

**Importante**  
Não compartilhe nenhum URL pré-assinado. A função `get_app_url` cria URLs pré-assinados, que se autenticam automaticamente com o domínio e perfil de usuário e dão acesso a todos as aplicações e arquivos associados ao domínio.

```
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
    )
)
```