TensorBoard Mit dem Modul öffnen sagemaker.interactive_apps.tensorboard

Das sagemaker.interactive_apps.tensorboard Modul bietet eine aufgerufene Funktionget_app_url, die unsignierte oder vorsignierte generiert URLs , um die TensorBoard Anwendung in einer beliebigen Umgebung in SageMaker AI oder Amazon zu öffnen. EC2 Dies soll sowohl Studio Classic- als auch Nicht-Studio Classic-Benutzern ein einheitliches Erlebnis bieten. In der Studio-Umgebung können Sie die get_app_url() Funktion öffnen, TensorBoard indem Sie sie unverändert ausführen, oder Sie können auch einen Jobnamen angeben, um die Nachverfolgung zu starten, sobald die TensorBoard Anwendung geöffnet wird. In Umgebungen, in denen es sich nicht um Studio Classic handelt, können Sie das Programm öffnen, TensorBoard indem Sie Ihre Domänen- und Benutzerprofilinformationen für die Utility-Funktion angeben. Mit dieser Funktion können Sie unabhängig davon, wo oder wie Sie Trainingscode ausführen und Trainingsjobs starten, direkt darauf zugreifen, TensorBoard indem Sie die get_app_url Funktion in Ihrem Jupyter-Notebook oder -Terminal ausführen.

Anmerkung

Diese Funktionalität ist im SageMaker Python-SDK v2.184.0 und höher verfügbar. Um diese Funktionalität nutzen zu können, stellen Sie sicher, dass Sie das SDK aktualisieren, indem Sie pip install sagemaker --upgrade ausführen.

Option 1: Für AI Studio Classic SageMaker

Wenn Sie SageMaker Studio Classic verwenden, können Sie die TensorBoard Anwendung direkt öffnen oder eine unsignierte URL abrufen, indem Sie die get_app_url Funktion wie folgt ausführen. Da Sie sich bereits in der Studio Classic-Umgebung befinden und als Domänenbenutzer angemeldet sind, wird eine unsignierte URL get_app_url() generiert, da eine erneute Authentifizierung nicht erforderlich ist.

Um die Anwendung zu öffnen TensorBoard

Der folgende Code öffnet die TensorBoard Anwendung automatisch über die unsignierte URL, die die get_app_url() Funktion im Standard-Webbrowser Ihrer Umgebung zurückgibt.

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 
)

Um eine unsignierte URL abzurufen und die TensorBoard Anwendung manuell zu öffnen

Der folgende Code druckt eine unsignierte URL, die Sie in einen Webbrowser kopieren und die TensorBoard Anwendung öffnen können.

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

Beachten Sie, dass die Funktion eine URL zur TensorBoard Landingpage in der SageMaker AI-Konsole zurückgibt, wenn Sie die beiden vorherigen Codebeispiele außerhalb der SageMaker AI Studio Classic-Umgebung ausführen, da diese keine Anmeldeinformationen für Ihre Domain und Ihr Benutzerprofil enthalten. Informationen zum Erstellen einer vorsignierten URL finden Sie unter Option 2 im folgenden Abschnitt.

Option 2: Für Umgebungen außerhalb von Studio Classic

Wenn Sie Umgebungen verwenden, in denen es sich nicht um Studio Classic handelt, z. B. die SageMaker Notebook-Instance oder Amazon EC2, und TensorBoard direkt von der Umgebung aus öffnen möchten, in der Sie sich befinden, müssen Sie eine URL generieren, die mit Ihrer Domain und Ihren Benutzerprofilinformationen vorsigniert ist. Eine vorsignierte URL ist eine URL, die bei Amazon SageMaker Studio Classic angemeldet ist, während die URL mit Ihrer Domain und Ihrem Benutzerprofil erstellt wird, und der somit Zugriff auf alle Domain-Anwendungen und Dateien gewährt wird, die mit Ihrer Domain verknüpft sind. Um TensorBoard über eine vorsignierte URL zu öffnen, verwenden Sie die get_app_url Funktion mit Ihrer Domain und Ihrem Benutzerprofilnamen wie folgt.

Beachten Sie, dass für diese Option der Domänenbenutzer über die sagemaker:CreatePresignedDomainUrl entsprechende Berechtigung verfügen muss. Ohne die Erlaubnis erhält der Domänenbenutzer einen Ausnahmefehler.

Wichtig

Teilen Sie keine vorab signierten URLs. Die get_app_url Funktion erstellt vorsignierte Dateien URLs, die sich automatisch mit Ihrer Domain und Ihrem Benutzerprofil authentifizieren und Zugriff auf alle Anwendungen und Dateien gewähren, die mit Ihrer Domain verknüpft sind.

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

Tipp

Die get_app_url Funktion führt die SageMaker.Client.create_presigned_domain_urlAPI AWS SDK for Python (Boto3) im Backend aus. Da die create_presigned_domain_url Boto3-API eine vorsignierte Domain erstellt URLs, die standardmäßig in 300 Sekunden abläuft, läuft die vorsignierte TensorBoard Anwendung URLs ebenfalls in 300 Sekunden ab. Wenn Sie die Ablaufzeit verlängern möchten, übergeben Sie das ExpiresInSeconds-Argument wie folgt an das optional_create_presigned_url_kwargs-Argument der Funktionget_app_url.

optional_create_presigned_url_kwargs={"ExpiresInSeconds": 1500}

Anmerkung

Wenn eine Ihrer an die Argumente von übergebenen Eingaben ungültig get_app_url ist, gibt die Funktion eine URL zur TensorBoard Landingpage aus, anstatt die Anwendung zu öffnen. TensorBoard Die Ausgabemeldung würde in etwa wie folgt aussehen.

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