> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/app/workspace/jobs/jobs-download-info.md).

# Downloading job information

For workspaces that are configured to write destination data to a container repository, the **Jobs** view also provides access to the generated artifacts. For more information, go to [Viewing and downloading container artifacts](/app/workflows/container-artifacts-view-download.md).

## Job logs <a href="#jobs-download-job-logs" id="jobs-download-job-logs"></a>

{% hint style="info" %}
**Required workspace permission:** Download job logs

To download diagnostic logs, you must have the **Enable diagnostic logging** global permission.
{% endhint %}

For all jobs, the job logs provide detailed information about the job processing. Tonic.ai support might request the job logs to help diagnose issues.

For upsert jobs where the migration process is enabled, and you configured the `GET Schema Change Logs` endpoint, the upsert job logs include the migration process logs.

### Where to download the job logs <a href="#job-logs-download-location" id="job-logs-download-location"></a>

You can download the job logs from the **Jobs** view or the job details view. The download includes up to 1MB of log entries.

On the **Jobs** view, to download the logs for a job, click the download icon in the rightmost column.

On the job details view, to download the logs for a job, click **Reports and Logs**, then select **Job Logs**.

### Downloading diagnostic logs <a href="#job-logs-download-diagnostic" id="job-logs-download-diagnostic"></a>

By default, Structural redacts sensitive values from the job logs. To help support troubleshooting, you can configure data connectors or an individual data generation job to create unredacted versions of the log files, referred to as diagnostic logs. For more information, go to [Redacted and diagnostic (unredacted) logs](/app/admin/tonic-monitoring-logging/logs-redacted-diagnostic.md).

To access diagnostic log files, you must have the **Enable diagnostic logging** global permission.

If you do not have the **Enable diagnostic logging** global permission, then you cannot download the logs for that job. The download option is disabled.

## Other logs for specific data connectors and data generation

### Additional logs for output to a container repository <a href="#logs-output-to-repos" id="logs-output-to-repos"></a>

For a workspace that [writes the output to a container repository](/app/workspace/workspace-configuration-settings/workspace-config-write-to-container-artifacts.md), the job includes the following additional logs:

* **Database logs -** Logs for the database container that is used as the destination.
* **Datapacker logs -** Logs for creating the OCI artifact and uploading it to an OCI registry.

To download these logs for a data generation job, on the job details view, click **Reports and Logs**, then select **Database Logs** or **Datapacker Logs**.

### CloudWatch logs for data generation <a href="#jobs-download-cloudwatch-logs" id="jobs-download-cloudwatch-logs"></a>

For workspaces that are connected to Amazon Redshift or Snowflake on AWS databases, the data generation job requires multiple calls to a Lambda function. For these data generation jobs, the CloudWatch logs monitor the progress of and display errors for these Lambda function calls.

To download the CloudWatch logs for a data generation job, on the job details view, click **Reports and Logs**, then select **CloudWatch Logs**.

The **CloudWatch Logs** option only displays for Amazon Redshift and Snowflake on AWS data generation jobs.

### Oracle SQL Loader log files <a href="#jobs-download-oracle-sql-loader-logs" id="jobs-download-oracle-sql-loader-logs"></a>

{% hint style="info" %}
**Required workspace permission:**  Download SqlLdr Files
{% endhint %}

For an Oracle data generation, if both of the following are true:

* The data generation job ran SQL Loader (sqlldr).
* sqlldr either failed or succeeded with errors.

Then to download the sqlldr log files, click **Reports and Logs**, then select **sqlldr Logs**.

## Sending a log package to Tonic.ai <a href="#job-upload-logs" id="job-upload-logs"></a>

{% hint style="info" %}
**Required global permission:** Enable diagnostic logging and uploading logs directly to Tonic.ai
{% endhint %}

The job details include an option to send a log package to Tonic.ai.

You would likely send the log package at the request of the Structural support team, to help to troubleshoot a data generation issue.

To send the package, from the **Reports and Logs** dropdown list, select **Send logs to Tonic.ai**.

Structural creates the package, then uploads it to an S3 bucket. Packages are removed from the S3 bucket automatically after 30 days.

## Privacy Report for data generation <a href="#jobs-download-privacy-report" id="jobs-download-privacy-report"></a>

{% hint style="info" %}
**Required workspace permission:** View and download Privacy Report
{% endhint %}

From the job details view, you can download a Privacy Report file that provides an overview of the current protection status of the database columns based on the workspace configuration at the time that the job ran.

You can download either:

* The Privacy Report .csv file, which provides details about the table columns, the column content, and the current protection configuration.
* The Privacy Report PDF file, which provides charts that summarize the privacy ranking scores for the table columns. It also includes the table from the .csv file.

To display the download options, click **Reports and Logs**. In the menu:

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FA7WAmtOAcfwupNIOBchf%2FJobDownloadMenu.png?alt=media&amp;token=c32ebbcd-6282-4cef-95f1-d7fb2f7b1604" alt=""><figcaption><p>Reports and Logs menu for a data generation job</p></figcaption></figure>

* To download the Privacy Report .csv file, click **Privacy Report CSV**.
* To download the Privacy Report PDF file, click **Privacy Report PDF**.

For more information about the **Privacy Report** files and their content, go to [Using the Privacy Report to verify data protection](/app/generation/privacy-report.md).

## Transformed files for file connector data generation <a href="#job-details-download-file-connector-files" id="job-details-download-file-connector-files"></a>

For a data generation from a file connector workspace that uses local files, you can download the transformed files for that job.

The download is a .zip file that contains the files for a selected file group.

On the job details view, when files are available to download, the **Data available for file groups** panel displays.

To download the files for a file group:

1. Click **Download Results**.
2. From the list, select the file group. Use the filter field to filter the list by the file group name.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2Ffos5y1dTShzuPtqFOjJO%2FFileConnector_JobDataAvailable.png?alt=media&amp;token=b31c0758-5bf5-4353-a856-8be43232eeaa" alt=""><figcaption><p>Job details option to download transformed file connector files</p></figcaption></figure>

## Performance metrics for data generation

{% hint style="info" %}
**Required workspace permission:** Download job logs
{% endhint %}

For workspaces that use the newer data generation processing, users can configure a data generation job to also [generate performance metrics](/app/workflows/data-generation-run-job/data-generation-manual.md#data-gen-manual-performance-metrics). This is usually done for troubleshooting purposes.

On the job details view, to download the performance metrics for the job, click **Reports and Logs**, then click **Performance Metrics**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tonic.ai/app/workspace/jobs/jobs-download-info.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
