Stay organized with collections
Save and categorize content based on your preferences.
After you define, build, and run a pipeline, you can view and query log
entries for your pipeline job and pipeline tasks. Learn more about
log entries for the Vertex AI API.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# View pipeline job logs\n\nAfter you define, build, and run a pipeline, you can view and query log\nentries for your pipeline job and pipeline tasks. Learn more about\n[log entries for the Vertex AI API](/logging/docs/api/platform-logs#vertex_ai_api).\n\nThis feature has costs associated with it. [Learn more about\nCloud Logging pricing](/logging#pricing).\n\nView Vertex AI logs for pipeline jobs\n-------------------------------------\n\nUse the following instructions to view logs for your Vertex AI Pipelines\njobs in the Google Cloud console or the Google Cloud CLI. \n\n### Console\n\n1. Enable the Cloud Logging API:\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=logging)\n2. In the Google Cloud console, go to the **Logs Explorer**:\n\n [Go to the Logs Explorer](https://console.cloud.google.com/logs/query)\n3. Select an existing Vertex AI project at the top of the page.\n\n4. In the **Query builder**, add the following:\n\n - **Resource** : Select **Vertex Pipelines Job**. In the dialog, select a Vertex AI Pipelines job.\n - **Log names** : In the Vertex AI section, select `aiplatform.googlapis.com/pipeline_job_events`.\n - **Severity**: Select a log level.\n - **Time range**: Select a preset range or create a custom range.\n\n### gcloud\n\n1. Run the following command to enable the Cloud Logging API:\n\n gcloud services enable logging.googleapis.com\n\n2.\n\n\n Execute the\n\n [gcloud logging read](/sdk/gcloud/reference/logging/read)\n\n command:\n\n #### Linux, macOS, or Cloud Shell\n\n **Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n ```bash\n gcloud logging read \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/aiplatform.googleapis.com/pipeline_job_events\" \\\n --limit=LIMIT\n ```\n\n #### Windows (PowerShell)\n\n **Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n ```bash\n gcloud logging read \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/aiplatform.googleapis.com/pipeline_job_events\" `\n --limit=LIMIT\n ```\n\n #### Windows (cmd.exe)\n\n **Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n ```bash\n gcloud logging read \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/aiplatform.googleapis.com/pipeline_job_events\" ^\n --limit=LIMIT\n ```\n\n \u003cbr /\u003e\n\nView Vertex AI logs for pipeline tasks\n--------------------------------------\n\nUse the following instructions to view logs for your Vertex AI Pipelines\ntasks in the Google Cloud console or the Google Cloud CLI. \n\n### Console\n\n1. Enable the Cloud Logging API:\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=logging)\n2. In the Google Cloud console, go to the **Logs Explorer**:\n\n [Go to the Logs Explorer](https://console.cloud.google.com/logs/query)\n3. Select an existing Vertex AI project at the top of the page.\n\n4. In the **Query builder**, add the following:\n\n - **Resource** : Select **Vertex Pipelines Job**. In the dialog, select a Vertex AI Pipelines job.\n - **Log names** : In the Vertex AI section, select `aiplatform.googlapis.com/pipeline_job_task_events`.\n - **Severity**: Select a log level.\n - **Time range**: Select a preset range or create a custom range.\n\n### gcloud\n\n1. Run the following command to enable the Cloud Logging API:\n\n gcloud services enable logging.googleapis.com\n\n2.\n\n\n Execute the\n\n [gcloud logging read](/sdk/gcloud/reference/logging/read)\n\n command:\n\n #### Linux, macOS, or Cloud Shell\n\n **Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n ```bash\n gcloud logging read \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/aiplatform.googleapis.com/pipeline_job_task_events\" \\\n --limit=LIMIT\n ```\n\n #### Windows (PowerShell)\n\n **Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n ```bash\n gcloud logging read \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/aiplatform.googleapis.com/pipeline_job_task_events\" `\n --limit=LIMIT\n ```\n\n #### Windows (cmd.exe)\n\n **Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n ```bash\n gcloud logging read \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/aiplatform.googleapis.com/pipeline_job_task_events\" ^\n --limit=LIMIT\n ```\n\n \u003cbr /\u003e\n\nWhat's next\n-----------\n\n- Learn how to [view pipeline metrics](/vertex-ai/docs/pipelines/metrics).\n\n- Learn how to [create custom metrics in the Logs Explorer](/vertex-ai/docs/pipelines/metrics#build-custom-metrics) to monitor the pipeline job failure rate.\n\n- Learn how to [configure email notifications](/vertex-ai/docs/pipelines/email-notifications)."]]
