You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: opentelemetry-auto-instrumentation/README.md
+25-25Lines changed: 25 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# Zero-code Instrumentation
1
+
# Opentelemetry Auto Instrumentation
2
2
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.
4
4
5
5
## What is OpenTelemetry?
6
6
@@ -10,19 +10,19 @@ OpenTelemetry provides a single set of APIs, libraries, agents, and collector se
10
10
11
11
## How does this gem fit in?
12
12
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].
14
14
15
15
## How do I get started?
16
16
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).
18
18
19
19
Install the gem using:
20
20
21
21
```console
22
-
gem install zero-code-instrumentation
22
+
gem install opentelemetry-auto-instrumentation
23
23
```
24
24
25
-
Install zero-code-instrumentation will automatically install following gems:
25
+
Installing opentelemetry-auto-instrumentation will automatically install following gems:
RUBYOPT="-r zero-code-instrumentation" rails server
80
+
RUBYOPT="-r opentelemetry-auto-instrumentation" rails server
81
81
```
82
82
83
-
Instrument Rails application with `bundle exec`
83
+
Instrument Rails application with `bundle exec`:
84
84
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.
86
86
87
87
```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
89
89
```
90
90
91
91
Instrument Sinatra application with rackup:
92
92
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.
|`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 |
131
131
|`OTEL_RUBY_OPERATOR`| Set to `true` to set the binding path for the OpenTelemetry Operator. |`/otel-auto-instrumentation-ruby`| N/A |
132
132
|`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`|
133
133
|`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
136
136
137
137
## How can I get involved?
138
138
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.
140
140
141
141
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].
142
142
143
143
## License
144
144
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.
0 commit comments