uptrace 1.8.1 → 1.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AGENTS.md +57 -0
- data/CLAUDE.md +1 -0
- data/RELEASING.md +13 -0
- data/lib/uptrace/dsn.rb +3 -0
- data/lib/uptrace/version.rb +2 -1
- metadata +25 -23
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 51c37073a96bd35e05bb1e01c69c43027e37b404e74d27039dc0466ee867cf75
|
|
4
|
+
data.tar.gz: 90ad2c151af18e2961220d94f15b6aa3ae7c69a6d729e146512efe384c74af47
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 9c5a09382b2772b528e8f23338d3661ac2c6dadb62a8c62ec3d786ac35ca7f038f43554510bbbbeb59518bc8d52aad6583ddfa11841dcaa4594ef6b90c3e4f26
|
|
7
|
+
data.tar.gz: 5110660bae14454665a7d56d0d5fd46757ec4d694b6d1bcede59291144233f9f3ff8c7df4882a0a90227c121e6711c0ea202e579424e02ae7b783b18feef76da
|
data/AGENTS.md
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# AGENTS.md
|
|
2
|
+
|
|
3
|
+
## Project Overview
|
|
4
|
+
|
|
5
|
+
uptrace-ruby is an OpenTelemetry Ruby distribution that configures OpenTelemetry SDK to export
|
|
6
|
+
traces, metrics, and logs to Uptrace via OTLP/HTTP. It is a thin wrapper — not a reimplementation.
|
|
7
|
+
|
|
8
|
+
## Build & Install
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
bundle install
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Commands
|
|
15
|
+
|
|
16
|
+
Run all checks (tests + rubocop + yard):
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
bundle exec rake
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Run individually:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
bundle exec rake test # minitest
|
|
26
|
+
bundle exec rake rubocop # linter
|
|
27
|
+
bundle exec rake yard # docs
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Architecture
|
|
31
|
+
|
|
32
|
+
All source lives in `lib/`:
|
|
33
|
+
|
|
34
|
+
- `uptrace.rb` — main module, `configure_opentelemetry` entry point, sets up span/metric/log
|
|
35
|
+
exporters with gzip compression and batch processing
|
|
36
|
+
- `uptrace/client.rb` — reads DSN from param or `UPTRACE_DSN` env var, generates trace URLs
|
|
37
|
+
- `uptrace/dsn.rb` — parses and validates Uptrace DSN connection strings
|
|
38
|
+
- `uptrace/id_generator.rb` — custom trace/span ID generator using timestamp + random bytes
|
|
39
|
+
- `uptrace/version.rb` — gem version constant
|
|
40
|
+
|
|
41
|
+
## Tests
|
|
42
|
+
|
|
43
|
+
Tests use Minitest in `test/`. Run with `bundle exec rake test`. Currently covers DSN parsing.
|
|
44
|
+
|
|
45
|
+
## Code Conventions
|
|
46
|
+
|
|
47
|
+
- All files start with `# frozen_string_literal: true`
|
|
48
|
+
- Ruby >= 3.0
|
|
49
|
+
- RuboCop enforced with `rubocop-rake` and `rubocop-minitest` plugins
|
|
50
|
+
- Line length, method length, and ABC size checks are disabled
|
|
51
|
+
- YARD documentation with Markdown markup
|
|
52
|
+
|
|
53
|
+
## Release Process
|
|
54
|
+
|
|
55
|
+
1. Update version in `lib/uptrace/version.rb`
|
|
56
|
+
2. `gem build uptrace.gemspec`
|
|
57
|
+
3. `gem push uptrace-X.Y.Z.gem`
|
data/CLAUDE.md
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
AGENTS.md
|
data/RELEASING.md
CHANGED
|
@@ -3,6 +3,19 @@
|
|
|
3
3
|
This guide explains how to release a new version of the uptrace-ruby gem to
|
|
4
4
|
RubyGems.
|
|
5
5
|
|
|
6
|
+
## Install Ruby
|
|
7
|
+
|
|
8
|
+
On Ubuntu, install Ruby with rbenv:
|
|
9
|
+
|
|
10
|
+
```shell
|
|
11
|
+
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
|
|
12
|
+
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
|
|
13
|
+
rbenv init
|
|
14
|
+
rbenv install -l
|
|
15
|
+
rbenv install 3.4.8
|
|
16
|
+
rbenv global 3.4.8
|
|
17
|
+
```
|
|
18
|
+
|
|
6
19
|
## Managing Dependencies
|
|
7
20
|
|
|
8
21
|
### Checking for outdated dependencies
|
data/lib/uptrace/dsn.rb
CHANGED
|
@@ -28,10 +28,12 @@ module Uptrace
|
|
|
28
28
|
@host = 'uptrace.dev' if @host == 'api.uptrace.dev'
|
|
29
29
|
end
|
|
30
30
|
|
|
31
|
+
# @return [String] the original DSN string
|
|
31
32
|
def to_s
|
|
32
33
|
@dsn
|
|
33
34
|
end
|
|
34
35
|
|
|
36
|
+
# @return [String] the Uptrace site URL for viewing traces
|
|
35
37
|
def site_url
|
|
36
38
|
return 'https://app.uptrace.dev' if @host == 'uptrace.dev'
|
|
37
39
|
return "#{@scheme}://#{@host}:#{@http_port}" if @http_port != 443
|
|
@@ -39,6 +41,7 @@ module Uptrace
|
|
|
39
41
|
"#{@scheme}://#{@host}"
|
|
40
42
|
end
|
|
41
43
|
|
|
44
|
+
# @return [String] the OTLP HTTP endpoint for exporting telemetry
|
|
42
45
|
def otlp_http_endpoint
|
|
43
46
|
return 'https://api.uptrace.dev' if @host == 'uptrace.dev'
|
|
44
47
|
return "#{@scheme}://#{@host}:#{@http_port}" if @http_port != 443
|
data/lib/uptrace/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: uptrace
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.
|
|
4
|
+
version: 1.11.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Uptrace Authors
|
|
8
8
|
bindir: bin
|
|
9
9
|
cert_chain: []
|
|
10
|
-
date:
|
|
10
|
+
date: 1980-01-02 00:00:00.000000000 Z
|
|
11
11
|
dependencies:
|
|
12
12
|
- !ruby/object:Gem::Dependency
|
|
13
13
|
name: logger
|
|
@@ -29,84 +29,84 @@ dependencies:
|
|
|
29
29
|
requirements:
|
|
30
30
|
- - "~>"
|
|
31
31
|
- !ruby/object:Gem::Version
|
|
32
|
-
version: 0.
|
|
32
|
+
version: 0.32.0
|
|
33
33
|
type: :runtime
|
|
34
34
|
prerelease: false
|
|
35
35
|
version_requirements: !ruby/object:Gem::Requirement
|
|
36
36
|
requirements:
|
|
37
37
|
- - "~>"
|
|
38
38
|
- !ruby/object:Gem::Version
|
|
39
|
-
version: 0.
|
|
39
|
+
version: 0.32.0
|
|
40
40
|
- !ruby/object:Gem::Dependency
|
|
41
41
|
name: opentelemetry-sdk
|
|
42
42
|
requirement: !ruby/object:Gem::Requirement
|
|
43
43
|
requirements:
|
|
44
44
|
- - "~>"
|
|
45
45
|
- !ruby/object:Gem::Version
|
|
46
|
-
version: 1.
|
|
46
|
+
version: 1.10.0
|
|
47
47
|
type: :runtime
|
|
48
48
|
prerelease: false
|
|
49
49
|
version_requirements: !ruby/object:Gem::Requirement
|
|
50
50
|
requirements:
|
|
51
51
|
- - "~>"
|
|
52
52
|
- !ruby/object:Gem::Version
|
|
53
|
-
version: 1.
|
|
53
|
+
version: 1.10.0
|
|
54
54
|
- !ruby/object:Gem::Dependency
|
|
55
55
|
name: opentelemetry-exporter-otlp-metrics
|
|
56
56
|
requirement: !ruby/object:Gem::Requirement
|
|
57
57
|
requirements:
|
|
58
58
|
- - "~>"
|
|
59
59
|
- !ruby/object:Gem::Version
|
|
60
|
-
version: 0.
|
|
60
|
+
version: 0.7.0
|
|
61
61
|
type: :runtime
|
|
62
62
|
prerelease: false
|
|
63
63
|
version_requirements: !ruby/object:Gem::Requirement
|
|
64
64
|
requirements:
|
|
65
65
|
- - "~>"
|
|
66
66
|
- !ruby/object:Gem::Version
|
|
67
|
-
version: 0.
|
|
67
|
+
version: 0.7.0
|
|
68
68
|
- !ruby/object:Gem::Dependency
|
|
69
69
|
name: opentelemetry-metrics-sdk
|
|
70
70
|
requirement: !ruby/object:Gem::Requirement
|
|
71
71
|
requirements:
|
|
72
72
|
- - "~>"
|
|
73
73
|
- !ruby/object:Gem::Version
|
|
74
|
-
version: 0.
|
|
74
|
+
version: 0.12.0
|
|
75
75
|
type: :runtime
|
|
76
76
|
prerelease: false
|
|
77
77
|
version_requirements: !ruby/object:Gem::Requirement
|
|
78
78
|
requirements:
|
|
79
79
|
- - "~>"
|
|
80
80
|
- !ruby/object:Gem::Version
|
|
81
|
-
version: 0.
|
|
81
|
+
version: 0.12.0
|
|
82
82
|
- !ruby/object:Gem::Dependency
|
|
83
83
|
name: opentelemetry-exporter-otlp-logs
|
|
84
84
|
requirement: !ruby/object:Gem::Requirement
|
|
85
85
|
requirements:
|
|
86
86
|
- - "~>"
|
|
87
87
|
- !ruby/object:Gem::Version
|
|
88
|
-
version: 0.
|
|
88
|
+
version: 0.3.0
|
|
89
89
|
type: :runtime
|
|
90
90
|
prerelease: false
|
|
91
91
|
version_requirements: !ruby/object:Gem::Requirement
|
|
92
92
|
requirements:
|
|
93
93
|
- - "~>"
|
|
94
94
|
- !ruby/object:Gem::Version
|
|
95
|
-
version: 0.
|
|
95
|
+
version: 0.3.0
|
|
96
96
|
- !ruby/object:Gem::Dependency
|
|
97
97
|
name: opentelemetry-logs-sdk
|
|
98
98
|
requirement: !ruby/object:Gem::Requirement
|
|
99
99
|
requirements:
|
|
100
100
|
- - "~>"
|
|
101
101
|
- !ruby/object:Gem::Version
|
|
102
|
-
version: 0.
|
|
102
|
+
version: 0.4.0
|
|
103
103
|
type: :runtime
|
|
104
104
|
prerelease: false
|
|
105
105
|
version_requirements: !ruby/object:Gem::Requirement
|
|
106
106
|
requirements:
|
|
107
107
|
- - "~>"
|
|
108
108
|
- !ruby/object:Gem::Version
|
|
109
|
-
version: 0.
|
|
109
|
+
version: 0.4.0
|
|
110
110
|
- !ruby/object:Gem::Dependency
|
|
111
111
|
name: bundler
|
|
112
112
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -141,56 +141,56 @@ dependencies:
|
|
|
141
141
|
requirements:
|
|
142
142
|
- - "~>"
|
|
143
143
|
- !ruby/object:Gem::Version
|
|
144
|
-
version: '13.
|
|
144
|
+
version: '13.3'
|
|
145
145
|
type: :development
|
|
146
146
|
prerelease: false
|
|
147
147
|
version_requirements: !ruby/object:Gem::Requirement
|
|
148
148
|
requirements:
|
|
149
149
|
- - "~>"
|
|
150
150
|
- !ruby/object:Gem::Version
|
|
151
|
-
version: '13.
|
|
151
|
+
version: '13.3'
|
|
152
152
|
- !ruby/object:Gem::Dependency
|
|
153
153
|
name: rubocop
|
|
154
154
|
requirement: !ruby/object:Gem::Requirement
|
|
155
155
|
requirements:
|
|
156
156
|
- - "~>"
|
|
157
157
|
- !ruby/object:Gem::Version
|
|
158
|
-
version: 1.
|
|
158
|
+
version: '1.86'
|
|
159
159
|
type: :development
|
|
160
160
|
prerelease: false
|
|
161
161
|
version_requirements: !ruby/object:Gem::Requirement
|
|
162
162
|
requirements:
|
|
163
163
|
- - "~>"
|
|
164
164
|
- !ruby/object:Gem::Version
|
|
165
|
-
version: 1.
|
|
165
|
+
version: '1.86'
|
|
166
166
|
- !ruby/object:Gem::Dependency
|
|
167
167
|
name: rubocop-minitest
|
|
168
168
|
requirement: !ruby/object:Gem::Requirement
|
|
169
169
|
requirements:
|
|
170
170
|
- - "~>"
|
|
171
171
|
- !ruby/object:Gem::Version
|
|
172
|
-
version: 0.
|
|
172
|
+
version: '0.39'
|
|
173
173
|
type: :development
|
|
174
174
|
prerelease: false
|
|
175
175
|
version_requirements: !ruby/object:Gem::Requirement
|
|
176
176
|
requirements:
|
|
177
177
|
- - "~>"
|
|
178
178
|
- !ruby/object:Gem::Version
|
|
179
|
-
version: 0.
|
|
179
|
+
version: '0.39'
|
|
180
180
|
- !ruby/object:Gem::Dependency
|
|
181
181
|
name: rubocop-rake
|
|
182
182
|
requirement: !ruby/object:Gem::Requirement
|
|
183
183
|
requirements:
|
|
184
184
|
- - "~>"
|
|
185
185
|
- !ruby/object:Gem::Version
|
|
186
|
-
version: 0.6
|
|
186
|
+
version: '0.6'
|
|
187
187
|
type: :development
|
|
188
188
|
prerelease: false
|
|
189
189
|
version_requirements: !ruby/object:Gem::Requirement
|
|
190
190
|
requirements:
|
|
191
191
|
- - "~>"
|
|
192
192
|
- !ruby/object:Gem::Version
|
|
193
|
-
version: 0.6
|
|
193
|
+
version: '0.6'
|
|
194
194
|
- !ruby/object:Gem::Dependency
|
|
195
195
|
name: yard
|
|
196
196
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -227,6 +227,8 @@ extensions: []
|
|
|
227
227
|
extra_rdoc_files: []
|
|
228
228
|
files:
|
|
229
229
|
- ".yardopts"
|
|
230
|
+
- AGENTS.md
|
|
231
|
+
- CLAUDE.md
|
|
230
232
|
- LICENSE
|
|
231
233
|
- README.md
|
|
232
234
|
- RELEASING.md
|
|
@@ -255,7 +257,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
255
257
|
- !ruby/object:Gem::Version
|
|
256
258
|
version: '0'
|
|
257
259
|
requirements: []
|
|
258
|
-
rubygems_version: 3.6.
|
|
260
|
+
rubygems_version: 3.6.9
|
|
259
261
|
specification_version: 4
|
|
260
262
|
summary: Uptrace wrapper for OpenTelemetry Ruby
|
|
261
263
|
test_files: []
|