

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buka TensorBoard menggunakan `sagemaker.interactive_apps.tensorboard` modul
<a name="debugger-htb-access-tb-url"></a>

`sagemaker.interactive_apps.tensorboard`Modul ini menyediakan fungsi yang disebut `get_app_url` yang menghasilkan URL yang tidak ditandatangani atau ditetapkan sebelumnya untuk membuka TensorBoard aplikasi di lingkungan apa pun di SageMaker AI atau Amazon EC2. Ini untuk memberikan pengalaman terpadu bagi pengguna Studio Classic dan non-Studio Classic. Untuk lingkungan Studio, Anda dapat membuka TensorBoard dengan menjalankan `get_app_url()` fungsi apa adanya, atau Anda juga dapat menentukan nama pekerjaan untuk mulai melacak saat TensorBoard aplikasi terbuka. Untuk lingkungan non-Studio Classic, Anda dapat membuka TensorBoard dengan memberikan informasi domain dan profil pengguna Anda ke fungsi utilitas. Dengan fungsi ini, terlepas dari di mana atau bagaimana Anda menjalankan kode pelatihan dan meluncurkan pekerjaan pelatihan, Anda dapat langsung mengakses TensorBoard dengan menjalankan `get_app_url` fungsi di notebook atau terminal Jupyter Anda.

**catatan**  
Fungsionalitas ini tersedia di SageMaker Python SDK v2.184.0 dan yang lebih baru. Untuk menggunakan fungsi ini, pastikan Anda memutakhirkan SDK dengan menjalankan`pip install sagemaker --upgrade`.

**Topics**
+ [Opsi 1: Untuk SageMaker AI Studio Classic](#debugger-htb-access-tb-url-unsigned)
+ [Opsi 2: Untuk lingkungan Klasik non-Studio](#debugger-htb-access-tb-url-presigned)

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

Jika Anda menggunakan SageMaker Studio Classic, Anda dapat langsung membuka TensorBoard aplikasi atau mengambil URL yang tidak ditandatangani dengan menjalankan `get_app_url` fungsi sebagai berikut. Karena Anda sudah berada dalam lingkungan Studio Classic dan masuk sebagai pengguna domain, buat URL yang `get_app_url()` tidak ditandatangani karena tidak perlu mengautentikasi lagi. 

**Untuk membuka TensorBoard aplikasi** 

Kode berikut secara otomatis membuka TensorBoard aplikasi dari URL yang tidak ditandatangani yang dikembalikan `get_app_url()` fungsi di browser web default lingkungan Anda.

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

**Untuk mengambil URL yang tidak ditandatangani dan membuka aplikasi secara manual TensorBoard**

Kode berikut mencetak URL yang tidak ditandatangani yang dapat Anda salin ke browser web dan membuka TensorBoard aplikasi.

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

Perhatikan bahwa jika Anda menjalankan dua contoh kode sebelumnya di luar lingkungan SageMaker AI Studio Classic, fungsi tersebut akan mengembalikan URL ke halaman TensorBoard arahan di konsol SageMaker AI, karena ini tidak memiliki informasi login ke domain dan profil pengguna Anda. Untuk membuat URL presigned, lihat Opsi 2 di bagian berikut.

## Opsi 2: Untuk lingkungan Klasik non-Studio
<a name="debugger-htb-access-tb-url-presigned"></a>

Jika Anda menggunakan lingkungan non-Studio Classic, seperti instans SageMaker Notebook atau Amazon EC2, dan ingin TensorBoard membuka langsung dari lingkungan tempat Anda berada, Anda perlu membuat URL yang telah ditetapkan sebelumnya dengan informasi domain dan profil pengguna Anda. URL *presigned* adalah URL yang masuk ke Amazon SageMaker Studio Classic saat URL dibuat dengan domain dan profil pengguna Anda, dan karenanya diberikan akses ke semua aplikasi domain dan file yang terkait dengan domain Anda. Untuk membuka TensorBoard melalui URL yang telah ditetapkan sebelumnya, gunakan `get_app_url` fungsi dengan nama domain dan profil pengguna Anda sebagai berikut.

Perhatikan bahwa opsi ini mengharuskan pengguna domain untuk memiliki `sagemaker:CreatePresignedDomainUrl` izin. Tanpa izin, pengguna domain akan menerima kesalahan pengecualian.

**penting**  
Jangan berbagi presigned URLs apapun. `get_app_url`Fungsi ini membuat presigned URLs, yang secara otomatis mengautentikasi dengan domain dan profil pengguna Anda dan memberikan akses ke aplikasi dan file apa pun yang terkait dengan domain Anda.

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

**Tip**  
`get_app_url`Fungsi menjalankan [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 untuk Python (Boto3) di backend. Karena Boto3 `create_presigned_domain_url` API membuat domain presigned URLs yang kedaluwarsa dalam 300 detik secara default, TensorBoard aplikasi presigned URLs juga kedaluwarsa dalam 300 detik. Jika Anda ingin memperpanjang waktu kedaluwarsa, berikan `ExpiresInSeconds` argumen ke `optional_create_presigned_url_kwargs` argumen `get_app_url` fungsi sebagai berikut.  

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

**catatan**  
Jika salah satu input Anda yang diteruskan ke argumen tidak valid, fungsi akan mengeluarkan URL ke halaman TensorBoard arahan alih-alih membuka aplikasi. `get_app_url` TensorBoard Pesan output akan mirip dengan yang berikut ini.  

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