Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengakses TensorBoard aplikasi di AI SageMaker
Anda dapat mengakses TensorBoard dengan dua metode: secara terprogram menggunakan `sagemaker.interactive_apps.tensorboard` modul yang menghasilkan URL yang tidak ditandatangani atau ditetapkan sebelumnya, atau menggunakan halaman TensorBoard arahan di konsol AI. SageMaker Setelah Anda membuka TensorBoard, SageMaker AI menjalankan TensorBoard plugin dan secara otomatis menemukan semua data output pekerjaan pelatihan dalam format file TensorBoard yang kompatibel.
**Topics**
+ [Buka TensorBoard menggunakan `sagemaker.interactive_apps.tensorboard` modul](debugger-htb-access-tb-url.md)
+ [Buka TensorBoard menggunakan `get_app_url` fungsi sebagai metode `estimator` kelas](debugger-htb-access-tb-get-app-url-estimator-method.md)
+ [Buka TensorBoard melalui konsol SageMaker AI](debugger-htb-access-tb-console.md)
# Buka TensorBoard menggunakan `sagemaker.interactive_apps.tensorboard` modul
`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
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
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
```
# Buka TensorBoard menggunakan `get_app_url` fungsi sebagai metode `estimator` kelas
Jika Anda sedang dalam proses menjalankan pekerjaan pelatihan menggunakan `estimator` kelas SDK SageMaker Python dan memiliki objek aktif `estimator` kelas, Anda juga dapat mengakses [`get_app_url`fungsi sebagai metode kelas kelas](https://sagemaker.readthedocs.io/en/stable/api/training/estimators.html#sagemaker.estimator.EstimatorBase.get_app_url). `estimator` Buka TensorBoard aplikasi atau ambil URL yang tidak ditandatangani dengan menjalankan `get_app_url` metode sebagai berikut. Metode `get_app_url` kelas menarik nama pekerjaan pelatihan dari estimator dan membuka TensorBoard aplikasi dengan pekerjaan yang ditentukan.
**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 Studio Classic](#debugger-htb-access-tb-get-app-url-estimator-method-studio)
+ [Opsi 2: Untuk lingkungan Klasik non-Studio](#debugger-htb-access-tb-get-app-url-estimator-method-non-studio)
## Opsi 1: Untuk SageMaker Studio Classic
**Untuk membuka TensorBoard aplikasi**
Kode berikut secara otomatis membuka TensorBoard aplikasi dari URL yang tidak ditandatangani yang dikembalikan `get_app_url()` metode di browser web default lingkungan Anda.
```
estimator.get_app_url(
app_type=SupportedInteractiveAppTypes.TENSORBOARD # Required.
)
```
**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.
```
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.
)
)
```
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
Jika Anda menggunakan lingkungan non-Studio Classic, seperti instans SageMaker Notebook dan Amazon EC2, dan ingin membuat URL yang telah ditetapkan sebelumnya untuk membuka TensorBoard aplikasi, gunakan metode dengan `get_app_url` informasi 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(
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
)
)
```
# Buka TensorBoard melalui konsol SageMaker AI
Anda juga dapat menggunakan UI konsol SageMaker AI untuk membuka TensorBoard aplikasi. Ada dua opsi untuk membuka TensorBoard aplikasi melalui konsol SageMaker AI.
**Topics**
+ [Opsi 1: Luncurkan TensorBoard dari halaman detail domain](#debugger-htb-access-tb-console-domain-detail)
+ [Opsi 2: Luncurkan TensorBoard dari halaman TensorBoard arahan](#debugger-htb-access-tb-console-landing-pg)
## Opsi 1: Luncurkan TensorBoard dari halaman detail domain
**Arahkan ke halaman detail domain**
Prosedur berikut menunjukkan cara menavigasi ke halaman detail domain.
1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Di panel navigasi kiri, pilih **Konfigurasi admin**.
1. Di bawah **konfigurasi Admin**, pilih **domain**.
1. Dari daftar domain, pilih domain tempat Anda ingin meluncurkan TensorBoard aplikasi.
**Luncurkan aplikasi profil pengguna**
Prosedur berikut menunjukkan cara meluncurkan aplikasi Studio Classic yang dicakup ke profil pengguna.
1. Pada halaman detail domain, pilih tab **Profil pengguna**.
1. Identifikasi profil pengguna yang ingin Anda luncurkan aplikasi Studio Classic.
1. Pilih **Luncurkan** untuk profil pengguna yang dipilih, lalu pilih **TensorBoard**.
## Opsi 2: Luncurkan TensorBoard dari halaman TensorBoard arahan
Prosedur berikut menjelaskan cara meluncurkan TensorBoard aplikasi dari halaman TensorBoard arahan.
1. Buka konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Di panel navigasi kiri, pilih **TensorBoard**.
1. Di bawah **Memulai**, pilih domain tempat Anda ingin meluncurkan aplikasi Studio Classic. Jika profil pengguna Anda hanya milik satu domain, Anda tidak melihat opsi untuk memilih domain.
1. Pilih profil pengguna yang ingin Anda luncurkan aplikasi Studio Classic. Jika tidak ada profil pengguna di domain, pilih **Buat profil pengguna**. Untuk informasi selengkapnya, lihat [Menambahkan dan Menghapus Profil Pengguna](https://docs.aws.amazon.com/sagemaker/latest/dg/domain-user-profile-add.html).
1. Pilih **Buka TensorBoard**.
Tangkapan layar berikut menunjukkan lokasi TensorBoard di panel navigasi kiri konsol SageMaker AI dan SageMaker AI dengan halaman TensorBoard arahan di panel utama.
![\[Halaman TensorBoard arahan\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/debugger/htb-landing-page.png)