{"id":21042768,"url":"https://github.com/aws-observability/aws-otel-ruby","last_synced_at":"2025-05-15T17:31:10.652Z","repository":{"id":37898498,"uuid":"447384197","full_name":"aws-observability/aws-otel-ruby","owner":"aws-observability","description":"AWS Distro for OpenTelemetry Ruby","archived":false,"fork":false,"pushed_at":"2024-09-16T17:20:16.000Z","size":2146,"stargazers_count":7,"open_issues_count":10,"forks_count":7,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-09-16T21:24:12.922Z","etag":null,"topics":["observability","opensource","opentelemetry","opentelemetry-api"],"latest_commit_sha":null,"homepage":"https://aws-otel.github.io/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-observability.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-12T22:05:29.000Z","updated_at":"2024-04-24T15:31:23.000Z","dependencies_parsed_at":"2024-09-16T21:00:34.553Z","dependency_job_id":"35461ce3-2590-4337-849e-e8c489c025df","html_url":"https://github.com/aws-observability/aws-otel-ruby","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-observability","download_url":"https://codeload.github.com/aws-observability/aws-otel-ruby/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225365962,"owners_count":17462973,"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":["observability","opensource","opentelemetry","opentelemetry-api"],"created_at":"2024-11-19T14:08:58.453Z","updated_at":"2024-11-19T14:08:59.158Z","avatar_url":"https://github.com/aws-observability.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Distro for OpenTelemetry Ruby Language\n\n## Introduction\n\nThis repo hosts documentation and sample apps for the ADOT Ruby library which provides the AWS service integrations for traces and metrics for the [OpenTelemetry Ruby](https://github.com/open-telemetry/opentelemetry-ruby) library. The library can be configured to support trace applications with the AWS X-Ray service. This way, traces generated by OpenTelemetry Ruby can be queried in the [AWS X-Ray console](https://console.aws.amazon.com/xray/home) where users can see information such as the duration, method invoked, status codes, and more.\n\nThis repository contains sample applications that are instrumented with ADOT Ruby. GitHub workflows on this repository continuously validate the integration experience of these sample apps with the AWS X-Ray backend using the [ADOT Test Framework](https://github.com/aws-observability/aws-otel-test-framework/tree/terraform). Use this repo to raise issues regarding ADOT Ruby integration or to discuss adding enhancements that cannot be covered by OpenTelemetry Ruby. ADOT is in preview for Ruby metrics. \n\nThis repo is regularly monitored by the AWS Observability team.\n\n## How it works\n\nOpenTelemetry is an open source project that give users better observability into their system. OpenTelemetry collects distributed traces and metrics from several popular packages your application is already using and exports the information to backends. As a backend, AWS X-Ray makes it easy to visualize and query traces in a user-friendly console packed with features to help users understand what happened during traced calls. Learn more about AWS X-Ray in the [developer guide](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html).\n\nWhen OpenTelemetry exports traces to the AWS X-Ray Console, the traces include parameters used in the call, results, exceptions, and more in the trace attributes. Read more about standardized attributes on the OpenTelemetry Specification [Semantic Conventions for traces](https://github.com/open-telemetry/opentelemetry-specification/tree/main/specification/trace/semantic_conventions).\n\nTo fully take advantage of the features of ADOT Ruby with AWS X-Ray, **we recommend you use both the X-Ray IDs Generator and the X-Ray Propagator when configuring the OpenTelemetry Ruby SDK**. The X-Ray IDs Generator makes sure Trace IDs are in the format AWS X-Ray expects, and the X-Ray Propagator adds a [X-Ray Tracing Header](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-traces) to outgoing requests so that the same context is propagated across different services and you get a connected view of all the traces in the X-Ray console.\n\nTo send traces to AWS X-Ray, use the [ADOT Collector](https://github.com/aws-observability/aws-otel-collector). The ADOT Collector includes packages from the [OpenTelemetry Collector](https://github.com/open-telemetry/opentelemetry-collector) to allow exporting to AWS X-Ray. ADOT Ruby is configured to export traces to the ADOT Collector and the collector uses its provided permissions and configuration to send those traces to AWS X-Ray.\n\n## Getting Started\n\nCheck out our public documentation for [tracing applications with ADOT Ruby](https://aws-otel.github.io/docs/getting-started/ruby-sdk/trace-manual-instr) to help you get started.\n\n### Sample Application - Manual instrumentation\n\nSee [a sample app manually instrumented with ADOT Ruby](sample-apps/manual-instrumentation/ruby-on-rails/README.md) that you can run yourself to understand the necessary setup for ADOT Ruby.\n\n## Requirements\n\nRuby 2.5+ is required to use OpenTelemetry Ruby. Check your currently installed Ruby version using `ruby -v`.\n\n## Useful Links\n\nFind out more about AWS X-Ray Tracing with Opentelemetry Ruby at the\nfollowing links.\n\n- [OpenTelemetry Ruby GitHub](https://github.com/open-telemetry/opentelemetry-ruby)\n- [ADOT Ruby X-Ray Propagator Package](https://github.com/open-telemetry/opentelemetry-ruby/tree/main/propagator/xray#opentelemetry-propagator-xray)\n- [AWS Distro for OpenTelemetry](https://aws-otel.github.io/)\n\n## Security issue notifications\n\nIf you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/). Please do **not** create a public github issue.\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\n\n## Support \nPlease note that as per policy, we're providing support via GitHub on a best effort basis. However, if you have AWS Enterprise Support you can create a ticket and we will provide direct support within the respective SLAs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-observability%2Faws-otel-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-observability%2Faws-otel-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-observability%2Faws-otel-ruby/lists"}