For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/amazon-glue.md. A documentation index is available at /llms.txt.

AWS Glue

Integration version1.0.1

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

Overview

AWS Glue is a fully managed ETL (extract, transform, and load) service that makes it simple and cost-effective to categorize your data, clean it, enrich it, and move it reliably between various data stores.

Enable this integration to see all your Glue metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that Glue is enabled under the Metric Collection tab.
  2. Install the Datadog - AWS Glue integration.

Log collection

Enable logging

Configure AWS Glue to send logs either to an S3 bucket or to CloudWatch. AWS Glue sends job logs to CloudWatch by default. The log group depends on the job type:

  • Spark jobs: /aws-glue/jobs/output and /aws-glue/jobs/error
  • Python Shell jobs: /aws-glue/python-jobs/output and /aws-glue/python-jobs/error
  • Ray jobs: /aws-glue/ray/jobs/*

Notes:

  • Datadog’s automatic trigger setup is available for CloudWatch log groups only. For S3 buckets, use the manual trigger setup. If you use the automatic trigger setup, ensure that your Datadog IAM policy has the following permissions:

    AWS PermissionDescription
    glue:ListJobsUsed to list available Glue jobs.
    glue:GetJobsUsed to get details on all Glue jobs.
    glue:GetJobUsed to get detailed information about a Glue job.
    glue:BatchGetJobsUsed to retrieve metadata for multiple Glue jobs.
  • If you log to a S3 bucket, make sure that amazon_glue is set as Target prefix.

  • If you use the --custom-logGroup-prefix argument for your Glue Jobs, use the log group name prefix /aws-glue/ for Datadog to identify the source of the logs and parse them automatically. Otherwise, they cannot be identified properly and will be tagged as source:cloudwatch.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.
  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS Glue logs in the AWS console:

Data Collected

Metrics

aws.glue.driver.executor_allocation_manager.executors.number_all_executors
(gauge)
The number of actively running job executors.
aws.glue.driver.executor_allocation_manager.executors.number_max_needed_executors
(gauge)
The number of maximum (actively running and pending) job executors needed to satisfy the current load.
aws.glue.glue_alljvm_heap_usage
(gauge)
The average fraction of memory used by the JVM heap for this driver (scale: 0-1) for all executors.
Shown as percent
aws.glue.glue_alljvm_heap_used
(gauge)
The number of memory bytes used by the JVM heap for all executors.
Shown as byte
aws.glue.glue_alls_3filesystem_readbytes
(gauge)
The average number of bytes read from Amazon S3 all executors since the previous report.
aws.glue.glue_allsystem_cpu_system_load
(gauge)
The average fraction of CPU system load used (scale: 0-1) by all executors.
Shown as percent
aws.glue.glue_driver_aggregate_bytes_read
(count)
The number of bytes read from all data sources by all completed Spark tasks running in all executors.
Shown as byte
aws.glue.glue_driver_aggregate_elapsed_time
(count)
The ETL elapsed time in milliseconds (does not include the job bootstrap times).
Shown as millisecond
aws.glue.glue_driver_aggregate_num_completed_stages
(count)
The number of completed stages in the job.
aws.glue.glue_driver_aggregate_num_completed_tasks
(count)
The number of completed tasks in the job.
aws.glue.glue_driver_aggregate_num_failed_tasks
(count)
The number of failed tasks.
aws.glue.glue_driver_aggregate_num_killed_tasks
(count)
The number of tasks killed.
aws.glue.glue_driver_aggregate_records_read
(count)
The number of records read from all data sources by all completed Spark tasks running in all executors.
aws.glue.glue_driver_aggregate_shuffle_bytes_written
(count)
The number of bytes written by all executors to shuffle data between them since the previous report.
aws.glue.glue_driver_aggregate_shuffle_local_bytes_read
(count)
The number of bytes read by all executors to shuffle data between them since the previous report.
aws.glue.glue_driver_block_manager_disk_disk_space_used_mb
(gauge)
The average number of megabytes of disk spaced used across all executors.
aws.glue.glue_driver_jvm_heap_usage
(gauge)
The average fraction of memory used by the JVM heap for this driver (scale: 0-1) for driver.
Shown as percent
aws.glue.glue_driver_jvm_heap_used
(gauge)
The number of memory bytes used by the JVM heap for the driver.
Shown as byte
aws.glue.glue_driver_s3_filesystem_readbytes
(gauge)
The average number of bytes read from Amazon S3 by the driver since the previous report.
aws.glue.glue_driver_s3_filesystem_writebytes
(gauge)
The average number of bytes written to Amazon S3 by the driver since the previous report.
aws.glue.glue_driver_system_cpu_system_load
(gauge)
The average fraction of CPU system load used (scale: 0-1) by the driver.
Shown as percent
aws.glue.glue_executor_id_jvm_heap_usage
(gauge)
The average fraction of memory used by the JVM heap for this driver (scale: 0-1) for executor identified.
Shown as percent
aws.glue.glue_executor_id_jvm_heap_used
(gauge)
The number of memory bytes used by the JVM heap for the executor identified.
Shown as byte
aws.glue.glue_executor_id_system_cpu_system_load
(gauge)
The average fraction of CPU system load used (scale: 0-1) by the executor identified.
Shown as percent
aws.glue.glue_executor_ids_3_filesystem_readbytes
(gauge)
The average number of bytes read from Amazon S3 by the executor identified since the previous report.
aws.glue.glue_executor_ids_3_filesystem_writebytes
(gauge)
The average number of bytes written to Amazon S3 by the executor identified since the previous report.
aws.glue.zeroetl.delete_count
(count)
The number of records deleted from the target Iceberg table.
Shown as record
aws.glue.zeroetl.ingestion_completed
(count)
The number of times ingestion completed successfully for the integration.
Shown as event
aws.glue.zeroetl.ingestion_failed
(count)
The number of times ingestion failed for the integration, reported as 1 per failed run.
Shown as event
aws.glue.zeroetl.insert_count
(count)
The number of records inserted in the target Iceberg table.
Shown as record
aws.glue.zeroetl.last_synced_timestamp
(gauge)
The timestamp until which the source has been synced to the target.
Shown as unix millisecond
aws.glue.zeroetl.source_delete_count
(count)
The number of records deleted at the source during ingestion.
Shown as record
aws.glue.zeroetl.source_ingestion_size_in_bytes
(count)
The amount of source data ingested.
Shown as byte
aws.glue.zeroetl.source_ingestion_succeeded
(count)
The number of successful source ingestion operations.
Shown as event
aws.glue.zeroetl.source_insert_count
(count)
The number of records inserted at the source during ingestion.
Shown as record
aws.glue.zeroetl.source_update_count
(count)
The number of records updated at the source during ingestion.
Shown as record
aws.glue.zeroetl.update_count
(count)
The number of records updated in the target Iceberg table.
Shown as record
aws.glue.dataquality.rules_failed
(count)
The number of rules that failed in a Data Quality evaluation.
aws.glue.dataquality.rules_passed
(count)
The number of rules that passed in a Data Quality evaluation.
aws.glue.dpu_hours_of_a_compaction_job
(count)
The number of DPU hours consumed by a compaction job.
Shown as hour
aws.glue.duration_of_job_hours
(gauge)
The duration of a table optimizer job.
Shown as hour
aws.glue.iceberg_table_compaction_failure
(count)
The number of failed Iceberg table compaction jobs.
Shown as job
aws.glue.iceberg_table_compaction_success
(count)
The number of successful Iceberg table compaction jobs.
Shown as job
aws.glue.iceberg_table_orphan_file_deletion_failure
(count)
The number of failed Iceberg table orphan-file deletion jobs.
Shown as job
aws.glue.iceberg_table_orphan_file_deletion_success
(count)
The number of successful Iceberg table orphan-file deletion jobs.
Shown as job
aws.glue.iceberg_table_retention_failure
(count)
The number of failed Iceberg table snapshot-retention jobs.
Shown as job
aws.glue.iceberg_table_retention_success
(count)
The number of successful Iceberg table snapshot-retention jobs.
Shown as job
aws.glue.number_of_bytes_compacted
(count)
The number of bytes compacted by the compaction job.
Shown as byte
aws.glue.number_of_data_file_bytes_removed
(count)
The number of data-file bytes removed by the compaction job.
Shown as byte
aws.glue.number_of_data_files_deleted
(count)
The number of data files deleted by the snapshot-retention job.
Shown as file
aws.glue.number_of_data_files_removed
(count)
The number of data files removed by the compaction job.
Shown as file
aws.glue.number_of_delete_file_bytes_removed
(count)
The number of delete-file bytes removed by the compaction job.
Shown as byte
aws.glue.number_of_delete_files_removed
(count)
The number of delete files removed by the compaction job.
Shown as file
aws.glue.number_of_dpus_allocated_to_compaction_job
(gauge)
The number of DPUs allocated to a compaction job.
aws.glue.number_of_dpus_allocated_to_orphan_file_deletion_job
(gauge)
The number of DPUs allocated to an orphan-file deletion job.
aws.glue.number_of_dpus_allocated_to_retention_job
(gauge)
The number of DPUs allocated to a snapshot-retention job.
aws.glue.number_of_files_compacted
(count)
The number of files compacted by the compaction job.
Shown as file
aws.glue.number_of_manifest_files_deleted
(count)
The number of manifest files deleted by the snapshot-retention job.
Shown as file
aws.glue.number_of_manifest_lists_deleted
(count)
The number of manifest lists deleted by the snapshot-retention job.
Shown as file
aws.glue.number_of_orphan_files_deleted
(count)
The number of orphan files deleted by the orphan-file deletion job.
Shown as file
aws.glue.resource_usage
(gauge)
The percentage of the applicable AWS Glue service quota currently in use.
Shown as percent

Events

The AWS Glue integration does not include any events.

Service Checks

The AWS Glue integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.