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 o `sagemaker.interactive_apps.tensorboard` módulo
<a name="debugger-htb-access-tb-url"></a>

O `sagemaker.interactive_apps.tensorboard` módulo fornece uma função chamada `get_app_url` that gera URLs não assinadas ou pré-assinadas para abrir o TensorBoard aplicativo em qualquer ambiente no SageMaker AI ou no Amazon EC2. Dessa forma, será fornecida uma experiência unificada tanto para usuários do Studio Classic e da versão não Classic. Para o ambiente Studio, você pode abrir TensorBoard executando a `get_app_url()` função como ela está ou também pode especificar um nome de trabalho para iniciar o rastreamento quando o TensorBoard aplicativo for aberto. Para ambientes que não sejam do Studio Classic, você pode abrir TensorBoard fornecendo suas informações de domínio e perfil de usuário para a função do utilitário. Com essa funcionalidade, independentemente de onde ou como você executa o código de treinamento e inicia trabalhos de treinamento, você pode acessar diretamente TensorBoard executando a `get_app_url` função em seu notebook ou terminal Jupyter.

**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 AI Studio Classic](#debugger-htb-access-tb-url-unsigned)
+ [Opção 2: para ambientes que não sejam do Studio Classic](#debugger-htb-access-tb-url-presigned)

## Opção 1: Para SageMaker AI Studio Classic
<a name="debugger-htb-access-tb-url-unsigned"></a>

Se você estiver usando o SageMaker Studio Classic, poderá abrir diretamente o TensorBoard aplicativo ou recuperar uma URL não assinada executando a `get_app_url` função da seguinte maneira. Como você já está no ambiente do Studio Classic e está conectado como usuário do domínio, o `get_app_url()` gera um URL não assinado porque não é necessário se autenticar novamente. 

**Para abrir o TensorBoard aplicativo** 

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

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

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

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

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-url-presigned"></a>

Se você usa ambientes que não são do Studio Classic, como a instância do SageMaker Notebook ou o Amazon EC2, e deseja TensorBoard abrir diretamente do ambiente em que está, você precisa gerar uma URL pré-assinada com suas informações de domínio e perfil de usuário. Uma URL *pré-assinada* é uma URL que está conectada ao Amazon SageMaker Studio Classic enquanto a URL está sendo criada com seu domínio e perfil de usuário e, portanto, concede acesso a todos os aplicativos e arquivos de domínio associados ao seu domínio. Para abrir TensorBoard por meio de um URL pré-assinado, use a `get_app_url` função com seu domínio e nome de 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 pré-assinado URLs. A `get_app_url` função cria presigned URLs, que se autentica automaticamente com seu domínio e perfil de usuário e dá acesso a todos os aplicativos e arquivos associados ao seu domínio.

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

**dica**  
A `get_app_url` função executa a [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 para Python (Boto3) no back-end. Como a `create_presigned_domain_url` API Boto3 cria um domínio pré-assinado URLs que expira em 300 segundos por padrão, o TensorBoard aplicativo pré-assinado URLs também expira em 300 segundos. Se você quiser estender o tempo de expiração, passe o argumento `ExpiresInSeconds` para o argumento `optional_create_presigned_url_kwargs` da função `get_app_url` da seguinte maneira:  

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

**nota**  
Se alguma de suas entradas passadas para os argumentos de `get_app_url` for inválida, a função exibirá um URL para a página de TensorBoard destino em vez de abrir o TensorBoard aplicativo. A mensagem de saída seria semelhante ao seguinte:  

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