Aprire TensorBoard usando il modulo sagemaker.interactive_apps.tensorboard

Il modulo sagemaker.interactive_apps.tensorboard fornisce una funzione chiamata get_app_url che genera URL senza firma o prefirmati per aprire l’applicazione TensorBoard in qualsiasi ambiente in SageMaker AI o Amazon EC2. Questo serve a fornire un’esperienza unificata per gli utenti, a prescindere che utilizzino o meno Studio Classic. Per l'ambiente Studio, puoi aprire TensorBoard eseguendo la funzione get_app_url() così com'è, oppure puoi specificare un nome di processo per avviare il tracciamento all'apertura dell'applicazione TensorBoard. Per gli ambienti non di Studio Classic, è possibile aprire TensorBoard fornendo le informazioni sul dominio e sul profilo utente alla funzione di utilità. Con questa funzionalità, indipendentemente da dove o come si esegue il codice di addestramento e si avviano i processi di addestramento, è possibile accedere direttamente a TensorBoard eseguendo la funzione get_app_url sul notebook o sul terminale Jupyter.

Opzione 1: per SageMaker AI Studio Classic

Se si utilizza SageMaker Studio Classic, è possibile aprire direttamente l’applicazione TensorBoard o recuperare un URL senza firma eseguendo la funzione get_app_url come segue. Poiché sei già all’interno dell’ambiente Studio Classic e hai effettuato l’accesso come utente di dominio, get_app_url() genera un URL senza firma, in quanto non è necessario eseguire nuovamente l’autenticazione.

Per aprire l’applicazione TensorBoard

Il codice seguente apre automaticamente l'applicazione TensorBoard dall'URL senza firma che la funzione get_app_url() restituisce nel browser Web predefinito dell'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 
)

Per recuperare un URL senza firma e aprire manualmente l'applicazione TensorBoard

Il codice seguente visualizza un URL senza firma che puoi copiare in un browser web e aprire nell’applicazione TensorBoard.

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

Se esegui i due esempi di codice precedenti al di fuori dell’ambiente SageMaker AI Studio Classic, la funzione restituisce un URL alla pagina di destinazione di TensorBoard nella console di SageMaker, poiché questi non contengono informazioni di accesso al tuo dominio e profilo utente. Per creare un URL predefinito, consulta l’opzione 2 nella sezione seguente.

Opzione 2: per ambienti non Studio Classic

Se utilizzi ambienti non Studio Classic, come l’istanza del notebook SageMaker o Amazon EC2, e desideri aprire TensorBoard direttamente dall’ambiente in cui ti trovi, devi generare un URL prefirmato con le informazioni del tuo dominio e del tuo profilo utente. Un URL predefinito è un URL che ha effettuato l’accesso ad Amazon SageMaker Studio Classic durante la creazione dell’URL con il tuo dominio e il tuo profilo utente e che quindi ha accesso a tutte le applicazioni e ai file di dominio associati al tuo dominio. Per aprire TensorBoard tramite un URL predefinito, utilizza la funzione get_app_url con il nome del dominio e del profilo utente, come segue.

Questa opzione richiede che l’utente del dominio disponga dell’autorizzazione sagemaker:CreatePresignedDomainUrl. Senza l’autorizzazione, l’utente del dominio riceve un errore di eccezione.

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

optional_create_presigned_url_kwargs={"ExpiresInSeconds": 1500}

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