Skip to content

Commit 5104dd8

Browse files
committed
change gem name
1 parent f432544 commit 5104dd8

File tree

14 files changed

+31
-31
lines changed

14 files changed

+31
-31
lines changed
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# Release History: opentelemetry-auto-instrumentation
File renamed without changes.
File renamed without changes.

zero-code-instrumentation/README.md renamed to opentelemetry-auto-instrumentation/README.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Zero-code Instrumentation
1+
# Opentelemetry Auto Instrumentation
22

3-
The `zero-code-instrumentation` gem provides an easy way to load and initialize opentelemetry-ruby for zero-code instrumentation.
3+
The `opentelemetry-auto-instrumentation` gem provides an easy way to load and initialize opentelemetry-ruby for zero-code instrumentation.
44

55
## What is OpenTelemetry?
66

@@ -10,19 +10,19 @@ OpenTelemetry provides a single set of APIs, libraries, agents, and collector se
1010

1111
## How does this gem fit in?
1212

13-
The `zero-code-instrumentation` gem provides an easy way to load and initialize the OpenTelemetry Ruby SDK without changing your code initialize the SDK. This gem is particularly used with the [OpenTelemetry Operator][opentelemetry-operator].
13+
The `opentelemetry-auto-instrumentation` gem provides an easy way to load and initialize the OpenTelemetry Ruby SDK without changing your code initialize the SDK. This gem is particularly used with the [OpenTelemetry Operator][opentelemetry-operator].
1414

1515
## How do I get started?
1616

17-
It's recommended to install this gem through gem install rather than Bundler since it doesn't require modifying any user's codebase (including the Gemfile).
17+
It's recommended to install this gem through `gem install` rather than Bundler since it doesn't require modifying your codebase (including the Gemfile).
1818

1919
Install the gem using:
2020

2121
```console
22-
gem install zero-code-instrumentation
22+
gem install opentelemetry-auto-instrumentation
2323
```
2424

25-
Install zero-code-instrumentation will automatically install following gems:
25+
Installing opentelemetry-auto-instrumentation will automatically install following gems:
2626
```console
2727
opentelemetry-sdk
2828
opentelemetry-api
@@ -38,7 +38,7 @@ opentelemetry-resource-detector-container
3838
Instrument your application:
3939

4040
```console
41-
RUBYOPT="-r zero-code-instrumentation" ruby application.rb
41+
RUBYOPT="-r opentelemetry-auto-instrumentation" ruby application.rb
4242
```
4343

4444
Instrument your application with additional environment variables:
@@ -49,75 +49,75 @@ export OTEL_EXPORTER_OTLP_ENDPOINT="your-endpoint"
4949
export OTEL_RUBY_RESOURCE_DETECTORS="container"
5050
export OTEL_SERVICE_NAME="your-service-name"
5151

52-
RUBYOPT="-r zero-code-instrumentation" ruby application.rb
52+
RUBYOPT="-r opentelemetry-auto-instrumentation" ruby application.rb
5353
```
5454

5555
Instrument your application with disabling certain instrumentation (e.g. sinatra):
5656

5757
```console
5858
export OTEL_RUBY_INSTRUMENTATION_SINATRA_ENABLED='false'
59-
RUBYOPT="-r zero-code-instrumentation" ruby application.rb
59+
RUBYOPT="-r opentelemetry-auto-instrumentation" ruby application.rb
6060
```
6161

6262
Instrument your application with only certain instrumentation installed (e.g. mysql, redis):
6363

6464
```console
6565
export OTEL_RUBY_ENABLED_INSTRUMENTATIONS='mysql2,redis'
66-
RUBYOPT="-r zero-code-instrumentation" ruby application.rb
66+
RUBYOPT="-r opentelemetry-auto-instrumentation" ruby application.rb
6767
```
6868

6969
Instrument your application with only redis and configure its options:
7070

7171
```console
7272
export OTEL_RUBY_ENABLED_INSTRUMENTATIONS='redis'
7373
export OTEL_RUBY_INSTRUMENTATION_REDIS_CONFIG_OPTS='peer_service=new_service;db_statement=omit'
74-
RUBYOPT="-r zero-code-instrumentation" ruby application.rb
74+
RUBYOPT="-r opentelemetry-auto-instrumentation" ruby application.rb
7575
```
7676

7777
Instrument Rails application:
7878

7979
```console
80-
RUBYOPT="-r zero-code-instrumentation" rails server
80+
RUBYOPT="-r opentelemetry-auto-instrumentation" rails server
8181
```
8282

83-
Instrument Rails application with `bundle exec`
83+
Instrument Rails application with `bundle exec`:
8484

85-
Since installing the `zero-code-instrumentation` gem through `gem install`, anything related to the OpenTelemetry gem won't be stored in Bundler's gem path. Therefore, users need to add an additional gem path that contains these gems prior to initialization.
85+
Since installing the `opentelemetry-auto-instrumentation` gem through `gem install`, anything related to the OpenTelemetry gem won't be stored in Bundler's gem path. Therefore, users need to add an additional gem path that contains these gems prior to initialization.
8686

8787
```console
88-
RUBYOPT="-r {PUT YOUR GEM PATH}/gems/zero-code-instrumentation-0.1.0/lib/zero-code-instrumentation" bundle exec rails server
88+
RUBYOPT="-r {PUT YOUR GEM PATH}/gems/opentelemetry-auto-instrumentation-0.1.0/lib/opentelemetry-auto-instrumentation" bundle exec rails server
8989
```
9090

9191
Instrument Sinatra application with rackup:
9292

93-
If you are using a Gemfile to install the required gems but without `Bundler.require`, set `REQUIRE_BUNDLER` to true. This way, `zero-code-instrumentation` will call `Bundler.require` to initialize the required gems prior to SDK initialization.
93+
If you are using a Gemfile to install the required gems but without `Bundler.require`, set `REQUIRE_BUNDLER` to true. This way, `opentelemetry-auto-instrumentation` will call `Bundler.require` to initialize the required gems prior to SDK initialization.
9494

9595
```console
9696
export REQUIRE_BUNDLER=true
97-
RUBYOPT="-r zero-code-instrumentation" rackup config.ru
97+
RUBYOPT="-r opentelemetry-auto-instrumentation" rackup config.ru
9898
```
9999

100-
If you wish to load some gems outside the Gemfile, then they need to be placed in front of zero-code-instrumentation:
100+
If you wish to load some gems outside the Gemfile, then they need to be placed in front of opentelemetry-auto-instrumentation:
101101

102102
```console
103103
export BUNDLE_WITHOUT=development,test
104104
gem install mysql2
105-
RUBYOPT="-r mysql2 -r zero-code-instrumentation" ruby application.rb
105+
RUBYOPT="-r mysql2 -r opentelemetry-auto-instrumentation" ruby application.rb
106106
```
107107

108108
## Example
109109

110110
In example folder, executing the following commands should result in trace output.
111111

112112
```console
113-
# if the user doesn't want to install zero-code-instrumentation from rubygems.org
113+
# if the user doesn't want to install opentelemetry-auto-instrumentation from rubygems.org
114114
# the user can build the gem and install it with gem install *.gem
115115

116-
gem install zero-code-instrumentation
116+
gem install opentelemetry-auto-instrumentation
117117
bundle install
118118
export REQUIRE_BUNDLER=true
119119
export OTEL_TRACES_EXPORTER=console
120-
RUBYOPT="-r zero-code-instrumentation" ruby app.rb
120+
RUBYOPT="-r opentelemetry-auto-instrumentation" ruby app.rb
121121
```
122122

123123
## Configuration
@@ -127,7 +127,7 @@ These environment variables are not standard OpenTelemetry environment variables
127127
| Environment Variable | Description | Default | Example |
128128
|----------------------|-------------|---------|---------|
129129
| `OTEL_RUBY_REQUIRE_BUNDLER` | Set to `true` if you are using Bundler to install gems but without `Bundler.require` in your script during initialization. | nil | N/A |
130-
| `OTEL_RUBY_ADDITIONAL_GEM_PATH` | Intended to be used for the OpenTelemetry Operator environment if you install `zero-code-instrumentation` to a customized path. | nil | N/A |
130+
| `OTEL_RUBY_ADDITIONAL_GEM_PATH` | Intended to be used for the OpenTelemetry Operator environment if you install `opentelemetry-auto-instrumentation` to a customized path. | nil | N/A |
131131
| `OTEL_RUBY_OPERATOR` | Set to `true` to set the binding path for the OpenTelemetry Operator. | `/otel-auto-instrumentation-ruby` | N/A |
132132
| `OTEL_RUBY_RESOURCE_DETECTORS` | Determine what kind of resource detector is needed. Currently supports `container`, `azure`, and `google_cloud_platform`. Use commas to separate multiple detectors. | nil | `container,azure` |
133133
| `OTEL_RUBY_ENABLED_INSTRUMENTATIONS` | Shortcut used when you only want to instrument one or a couple of particular libraries. | nil | `redis,active_record` |
@@ -136,13 +136,13 @@ These environment variables are not standard OpenTelemetry environment variables
136136

137137
## How can I get involved?
138138

139-
The `zero-code-instrumentation` gem source is on GitHub, along with related gems.
139+
The `opentelemetry-auto-instrumentation` gem source is on GitHub, along with related gems.
140140

141141
The OpenTelemetry Ruby gems are maintained by the OpenTelemetry Ruby special interest group (SIG). You can get involved by joining us on our [GitHub Discussions][discussions-url], [Slack Channel][slack-channel] or attending our weekly meeting. See the [meeting calendar][community-meetings] for dates and times. For more information on this and other language SIGs, see the OpenTelemetry [community page][ruby-sig].
142142

143143
## License
144144

145-
The `zero-code-instrumentation` gem is distributed under the Apache 2.0 license. See LICENSE for more information.
145+
The `opentelemetry-auto-instrumentation` gem is distributed under the Apache 2.0 license. See LICENSE for more information.
146146

147147
[ruby-sig]: https://github.com/open-telemetry/community#ruby-sig
148148
[community-meetings]: https://github.com/open-telemetry/community#community-meetings
File renamed without changes.

0 commit comments

Comments
 (0)