{"id":15145745,"url":"https://github.com/soundcloud/sqs-exporter","last_synced_at":"2025-09-29T15:31:03.714Z","repository":{"id":45033032,"uuid":"363914411","full_name":"soundcloud/sqs-exporter","owner":"soundcloud","description":"A Prometheus Exporter for the Amazon Simple Queue Service (SQS)","archived":false,"fork":true,"pushed_at":"2023-04-09T21:02:45.000Z","size":47,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-09-27T11:42:20.964Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jmal98/sqs-exporter","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soundcloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-03T11:58:33.000Z","updated_at":"2021-12-14T09:07:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/soundcloud/sqs-exporter","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fsqs-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fsqs-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fsqs-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soundcloud%2Fsqs-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soundcloud","download_url":"https://codeload.github.com/soundcloud/sqs-exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234635026,"owners_count":18863988,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-26T11:42:25.467Z","updated_at":"2025-09-29T15:31:03.419Z","avatar_url":"https://github.com/soundcloud.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Amazon Simple Queue Service (SQS) Exporter\n\nA Prometheus exporter for the Amazon Simple Queue Service metrics.\n\n### Build\n```bash\ndocker build --tag sqs-exporter  .\n```\n\n### Exported Metrics\n\n| Metric  | Labels |\n| ------  | ------ |\n| sqs_ATTRIBUTE_NAME | Queue Name |\n\n\n\n* ApproximateNumberOfMessages - Approximate number of visible messages in a queue. For more information, see Resources Required to Process Messages in the Amazon SQS Developer Guide.\n* ApproximateNumberOfMessagesDelayed - Approximate number of messages that are waiting to be added to the queue.\n* ApproximateNumberOfMessagesNotVisible - Approximate number of messages that have not timed-out and aren't deleted. For more information, see Resources Required to Process Messages in the Amazon SQS Developer Guide.\n\n### Configuration\nAWS credentials can be provided via the following:\n\n* Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY\n* Credentials delivered through the Amazon EC2 container service if AWS_CONTAINER_CREDENTIALS_RELATIVE_URI\" environment variable is set and security manager has permission to access the variable,\n* Instance profile credentials delivered through the Amazon EC2 metadata service if running within AWS\n* IAM role applied to either an Amazon Elastic Container Service (ECS) service or task\n\nBy default, the exporter will watch all SQS queues visible to the AWS account. To watch a specific set of queues, supply one of these parameters:\n* a comma-separated list of queue names in the environment variable `SQS_QUEUE_NAMES`;\n* a single queue prefix in `SQS_QUEUE_NAME_PREFIX`. (SQS_QUEUE_NAMES takes precedence over SQS_QUEUE_NAME_PREFIX);\n* a comma-separated list of queue URLs in `SQS_QUEUE_URLS`.\n\nWith no parameters specified via environment variables, the full list of queues will be returned.\n\n## Docker\n\nYou can deploy this exporter using the [jmal98/sqs-exporter](https://hub.docker.com/r/jmal98/sqs-exporter/) Docker image.\n\nIf you run in AWS, the following will assume it's running with an IAM profile which will allow read access to SQS information.\n\n```bash\ndocker run -d -p 9384:9384 jmal98/sqs-exporter:0.0.7\n```\n\nUse the following to pass the queue filtering environment variables to the docker container.\n\n```bash\ndocker run -d -e SQS_QUEUE_NAME_PREFIX='example_queue_prefix' -p 9384:9384 jmal98/sqs-exporter:0.0.7\n```\n\nIf you would like to run the exporter with supplied environment configuration, the following will work both inside and outside of AWS.  This is useful if you desire to run the exporter externally.\n\n```bash\ndocker run -d -p 9384:9384 -e AWS_ACCESS_KEY_ID=\u003caccess key\u003e -e AWS_SECRET_ACCESS_KEY=\u003csecret key\u003e -e AWS_REGION=\u003cregion\u003e  jmal98/sqs-exporter:0.0.7\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoundcloud%2Fsqs-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoundcloud%2Fsqs-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoundcloud%2Fsqs-exporter/lists"}