Ábrelo TensorBoard usando el módulo sagemaker.interactive_apps.tensorboard

El sagemaker.interactive_apps.tensorboard módulo proporciona una función llamada get_app_url que genera sin firmar o prefirmada URLs para abrir la TensorBoard aplicación en cualquier entorno de SageMaker Amazon. EC2 El objetivo es proporcionar una experiencia unificada tanto a los usuarios de Studio Classic como a los que no lo son. En el entorno de Studio, puede abrirla TensorBoard ejecutando la get_app_url() función tal como está, o también puede especificar un nombre de trabajo para iniciar el seguimiento a medida que se abra la TensorBoard aplicación. En el caso de entornos que no sean de Studio Classic, puede TensorBoard abrirlos proporcionando la información de su dominio y perfil de usuario a la función de utilidad. Con esta funcionalidad, independientemente de dónde o cómo ejecute el código de formación y lance los trabajos de formación, puede acceder directamente a ella TensorBoard ejecutando la get_app_url función en su portátil o terminal Jupyter.

nota

Esta funcionalidad está disponible en SageMaker Python SDK v2.184.0 y versiones posteriores. Para utilizar esta funcionalidad, asegúrese de actualizarla ejecutándola. SDK pip install sagemaker --upgrade

Opción 1: para SageMaker Studio Classic

Si utiliza SageMaker Studio Classic, puede abrir directamente la TensorBoard aplicación o recuperar una aplicación sin firmar URL ejecutando la get_app_url función de la siguiente manera. Como ya se encuentra en el entorno de Studio Classic y ha iniciado sesión como usuario del dominio, get_app_url() genera datos sin firmar, URL ya que no es necesario volver a autenticarse.

Para abrir la aplicación TensorBoard

El siguiente código abre automáticamente la TensorBoard aplicación desde la parte sin firmar URL que la get_app_url() función devuelve en el navegador web predeterminado de su entorno.

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 una aplicación sin firmar URL y abrirla manualmente TensorBoard

El siguiente código imprime un código sin firmar URL que puede copiar en un navegador web y abrir la TensorBoard aplicación.

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

Tenga en cuenta que si ejecuta los dos ejemplos de código anteriores fuera del entorno de SageMaker Studio Classic, la función volverá URL a la página de TensorBoard inicio de la SageMaker consola, ya que no contienen información de inicio de sesión en su dominio ni en su perfil de usuario. Para crear un prefirmadoURL, consulte la opción 2 en la siguiente sección.

Opción 2: para entornos que no sean de Studio Classic

Si utilizas entornos que no son de Studio Classic, como SageMaker Notebook instance o AmazonEC2, y quieres abrir TensorBoard directamente desde el entorno en el que te encuentras, necesitas generar un URL prefirmado con la información de tu dominio y perfil de usuario. Un prefirmado URL es aquel URL que ha iniciado sesión en Amazon SageMaker Studio Classic mientras URL se crea con su dominio y perfil de usuario y, por lo tanto, tiene acceso a todas las aplicaciones y archivos de dominio asociados a su dominio. Para abrir a TensorBoard través de un prefirmadoURL, usa la get_app_url función con tu dominio y nombre de perfil de usuario de la siguiente manera.

Tenga en cuenta que esta opción requiere que el usuario del dominio tenga el sagemaker:CreatePresignedDomainUrl permiso. Sin el permiso, el usuario del dominio recibirá un error de excepción.

importante

No compartas ningún prefirmadoURLs. La get_app_url función crea un código prefirmadoURLs, que se autentica automáticamente con tu dominio y perfil de usuario y da acceso a todas las aplicaciones y archivos asociados a tu dominio.

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

sugerencia

La get_app_url función se ejecuta SageMaker.Client.create_presigned_domain_urlAPI AWS SDK for Python (Boto3) en el backend. Como el Boto3 create_presigned_domain_url API crea un dominio prefirmado URLs que vence en 300 segundos de forma predeterminada, la TensorBoard aplicación prefirmada URLs también caduca en 300 segundos. Si desea extender el tiempo de caducidad, pase el ExpiresInSeconds argumento al argumento de la función de la optional_create_presigned_url_kwargs get_app_url siguiente manera.

optional_create_presigned_url_kwargs={"ExpiresInSeconds": 1500}

nota

Si alguna de las entradas transferidas a los argumentos de no get_app_url es válida, la función envía un mensaje URL a a la página de TensorBoard destino en lugar de abrir la TensorBoard aplicación. El mensaje de salida sería similar al siguiente.

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