solana-ruby-watchtower 0.1.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 +7 -0
- data/CHANGELOG.md +14 -0
- data/LICENSE +21 -0
- data/README.md +181 -0
- data/examples/solana-watchtower.service +28 -0
- data/examples/watchtower.yml +56 -0
- data/exe/solana-watchtower +9 -0
- data/lib/solana/ruby/watchtower/check_state.rb +98 -0
- data/lib/solana/ruby/watchtower/cli.rb +133 -0
- data/lib/solana/ruby/watchtower/config.rb +134 -0
- data/lib/solana/ruby/watchtower/heartbeat.rb +27 -0
- data/lib/solana/ruby/watchtower/monitor.rb +189 -0
- data/lib/solana/ruby/watchtower/notifiers.rb +100 -0
- data/lib/solana/ruby/watchtower/observe.rb +46 -0
- data/lib/solana/ruby/watchtower/rpc.rb +111 -0
- data/lib/solana/ruby/watchtower/runner.rb +51 -0
- data/lib/solana/ruby/watchtower/stores/active_record_store.rb +35 -0
- data/lib/solana/ruby/watchtower/stores/file_store.rb +56 -0
- data/lib/solana/ruby/watchtower/stores/memory_store.rb +29 -0
- data/lib/solana/ruby/watchtower/version.rb +9 -0
- data/lib/solana/ruby/watchtower.rb +34 -0
- data/solana-ruby-watchtower.gemspec +43 -0
- metadata +127 -0
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module Solana
|
|
4
|
+
module Ruby
|
|
5
|
+
# Off-box monitoring for a Solana validator or an active/standby pair.
|
|
6
|
+
#
|
|
7
|
+
# The pieces, from the bottom up:
|
|
8
|
+
#
|
|
9
|
+
# Rpc / RpcPool JSON-RPC over net/http, tried endpoint by endpoint
|
|
10
|
+
# Observe reads the vote account and the gossip table
|
|
11
|
+
# CheckState alert state of one check: fire, remind, resolve
|
|
12
|
+
# Stores::* where CheckStates live between runs
|
|
13
|
+
# Notifiers::* where alerts go
|
|
14
|
+
# Monitor runs the checks and turns results into alerts
|
|
15
|
+
# Runner / CLI the long-running daemon around a Monitor
|
|
16
|
+
module Watchtower
|
|
17
|
+
class Error < StandardError; end
|
|
18
|
+
end
|
|
19
|
+
end
|
|
20
|
+
end
|
|
21
|
+
|
|
22
|
+
require_relative 'watchtower/version'
|
|
23
|
+
require_relative 'watchtower/config'
|
|
24
|
+
require_relative 'watchtower/rpc'
|
|
25
|
+
require_relative 'watchtower/observe'
|
|
26
|
+
require_relative 'watchtower/check_state'
|
|
27
|
+
require_relative 'watchtower/stores/memory_store'
|
|
28
|
+
require_relative 'watchtower/stores/file_store'
|
|
29
|
+
require_relative 'watchtower/stores/active_record_store'
|
|
30
|
+
require_relative 'watchtower/notifiers'
|
|
31
|
+
require_relative 'watchtower/heartbeat'
|
|
32
|
+
require_relative 'watchtower/monitor'
|
|
33
|
+
require_relative 'watchtower/runner'
|
|
34
|
+
require_relative 'watchtower/cli'
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require_relative 'lib/solana/ruby/watchtower/version'
|
|
4
|
+
|
|
5
|
+
Gem::Specification.new do |spec|
|
|
6
|
+
spec.name = 'solana-ruby-watchtower'
|
|
7
|
+
spec.version = Solana::Ruby::Watchtower::VERSION
|
|
8
|
+
spec.authors = ['Paul Zupan, Idhra Inc.']
|
|
9
|
+
spec.summary = 'Off-box monitor for Solana validators, including active/standby HA pairs'
|
|
10
|
+
spec.description = <<~DESC
|
|
11
|
+
Watches a Solana validator from the cluster's side, the way agave-watchtower
|
|
12
|
+
does, and adds the checks an active/standby pair needs: each node present in
|
|
13
|
+
gossip, the staked identity on a known host, and the staked identity
|
|
14
|
+
advertised by two nodes at once. Alerts go to Telegram or a webhook (Slack or
|
|
15
|
+
Discord) once, again while a problem lasts, and when it clears.
|
|
16
|
+
DESC
|
|
17
|
+
spec.homepage = 'https://github.com/idhra/solana-ruby-watchtower'
|
|
18
|
+
spec.license = 'MIT'
|
|
19
|
+
spec.required_ruby_version = '>= 3.2.0'
|
|
20
|
+
spec.require_paths = ['lib']
|
|
21
|
+
spec.bindir = 'exe'
|
|
22
|
+
spec.executables = ['solana-watchtower']
|
|
23
|
+
|
|
24
|
+
spec.metadata = {
|
|
25
|
+
'source_code_uri' => "#{spec.homepage}/tree/main",
|
|
26
|
+
'bug_tracker_uri' => "#{spec.homepage}/issues",
|
|
27
|
+
'changelog_uri' => "#{spec.homepage}/blob/main/CHANGELOG.md",
|
|
28
|
+
'rubygems_mfa_required' => 'true'
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
spec.files = Dir['lib/**/*.rb', 'exe/*', 'examples/*'] +
|
|
32
|
+
['LICENSE', 'README.md', 'CHANGELOG.md', 'solana-ruby-watchtower.gemspec']
|
|
33
|
+
spec.extra_rdoc_files = ['LICENSE', 'README.md']
|
|
34
|
+
|
|
35
|
+
# Runtime is the standard library only (net/http, json, yaml), so an operator
|
|
36
|
+
# can run it on a small box without libsodium or a Solana SDK. logger leaves
|
|
37
|
+
# the default gems in Ruby 3.5, hence the explicit dependency.
|
|
38
|
+
spec.add_dependency 'logger', '~> 1.6'
|
|
39
|
+
|
|
40
|
+
spec.add_development_dependency 'rake', '~> 13.0'
|
|
41
|
+
spec.add_development_dependency 'rspec', '~> 3.13'
|
|
42
|
+
spec.add_development_dependency 'webmock', '~> 3.26'
|
|
43
|
+
end
|
metadata
ADDED
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
|
2
|
+
name: solana-ruby-watchtower
|
|
3
|
+
version: !ruby/object:Gem::Version
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
platform: ruby
|
|
6
|
+
authors:
|
|
7
|
+
- Paul Zupan, Idhra Inc.
|
|
8
|
+
bindir: exe
|
|
9
|
+
cert_chain: []
|
|
10
|
+
date: 1980-01-02 00:00:00.000000000 Z
|
|
11
|
+
dependencies:
|
|
12
|
+
- !ruby/object:Gem::Dependency
|
|
13
|
+
name: logger
|
|
14
|
+
requirement: !ruby/object:Gem::Requirement
|
|
15
|
+
requirements:
|
|
16
|
+
- - "~>"
|
|
17
|
+
- !ruby/object:Gem::Version
|
|
18
|
+
version: '1.6'
|
|
19
|
+
type: :runtime
|
|
20
|
+
prerelease: false
|
|
21
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
22
|
+
requirements:
|
|
23
|
+
- - "~>"
|
|
24
|
+
- !ruby/object:Gem::Version
|
|
25
|
+
version: '1.6'
|
|
26
|
+
- !ruby/object:Gem::Dependency
|
|
27
|
+
name: rake
|
|
28
|
+
requirement: !ruby/object:Gem::Requirement
|
|
29
|
+
requirements:
|
|
30
|
+
- - "~>"
|
|
31
|
+
- !ruby/object:Gem::Version
|
|
32
|
+
version: '13.0'
|
|
33
|
+
type: :development
|
|
34
|
+
prerelease: false
|
|
35
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
36
|
+
requirements:
|
|
37
|
+
- - "~>"
|
|
38
|
+
- !ruby/object:Gem::Version
|
|
39
|
+
version: '13.0'
|
|
40
|
+
- !ruby/object:Gem::Dependency
|
|
41
|
+
name: rspec
|
|
42
|
+
requirement: !ruby/object:Gem::Requirement
|
|
43
|
+
requirements:
|
|
44
|
+
- - "~>"
|
|
45
|
+
- !ruby/object:Gem::Version
|
|
46
|
+
version: '3.13'
|
|
47
|
+
type: :development
|
|
48
|
+
prerelease: false
|
|
49
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
50
|
+
requirements:
|
|
51
|
+
- - "~>"
|
|
52
|
+
- !ruby/object:Gem::Version
|
|
53
|
+
version: '3.13'
|
|
54
|
+
- !ruby/object:Gem::Dependency
|
|
55
|
+
name: webmock
|
|
56
|
+
requirement: !ruby/object:Gem::Requirement
|
|
57
|
+
requirements:
|
|
58
|
+
- - "~>"
|
|
59
|
+
- !ruby/object:Gem::Version
|
|
60
|
+
version: '3.26'
|
|
61
|
+
type: :development
|
|
62
|
+
prerelease: false
|
|
63
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
64
|
+
requirements:
|
|
65
|
+
- - "~>"
|
|
66
|
+
- !ruby/object:Gem::Version
|
|
67
|
+
version: '3.26'
|
|
68
|
+
description: |
|
|
69
|
+
Watches a Solana validator from the cluster's side, the way agave-watchtower
|
|
70
|
+
does, and adds the checks an active/standby pair needs: each node present in
|
|
71
|
+
gossip, the staked identity on a known host, and the staked identity
|
|
72
|
+
advertised by two nodes at once. Alerts go to Telegram or a webhook (Slack or
|
|
73
|
+
Discord) once, again while a problem lasts, and when it clears.
|
|
74
|
+
executables:
|
|
75
|
+
- solana-watchtower
|
|
76
|
+
extensions: []
|
|
77
|
+
extra_rdoc_files:
|
|
78
|
+
- LICENSE
|
|
79
|
+
- README.md
|
|
80
|
+
files:
|
|
81
|
+
- CHANGELOG.md
|
|
82
|
+
- LICENSE
|
|
83
|
+
- README.md
|
|
84
|
+
- examples/solana-watchtower.service
|
|
85
|
+
- examples/watchtower.yml
|
|
86
|
+
- exe/solana-watchtower
|
|
87
|
+
- lib/solana/ruby/watchtower.rb
|
|
88
|
+
- lib/solana/ruby/watchtower/check_state.rb
|
|
89
|
+
- lib/solana/ruby/watchtower/cli.rb
|
|
90
|
+
- lib/solana/ruby/watchtower/config.rb
|
|
91
|
+
- lib/solana/ruby/watchtower/heartbeat.rb
|
|
92
|
+
- lib/solana/ruby/watchtower/monitor.rb
|
|
93
|
+
- lib/solana/ruby/watchtower/notifiers.rb
|
|
94
|
+
- lib/solana/ruby/watchtower/observe.rb
|
|
95
|
+
- lib/solana/ruby/watchtower/rpc.rb
|
|
96
|
+
- lib/solana/ruby/watchtower/runner.rb
|
|
97
|
+
- lib/solana/ruby/watchtower/stores/active_record_store.rb
|
|
98
|
+
- lib/solana/ruby/watchtower/stores/file_store.rb
|
|
99
|
+
- lib/solana/ruby/watchtower/stores/memory_store.rb
|
|
100
|
+
- lib/solana/ruby/watchtower/version.rb
|
|
101
|
+
- solana-ruby-watchtower.gemspec
|
|
102
|
+
homepage: https://github.com/idhra/solana-ruby-watchtower
|
|
103
|
+
licenses:
|
|
104
|
+
- MIT
|
|
105
|
+
metadata:
|
|
106
|
+
source_code_uri: https://github.com/idhra/solana-ruby-watchtower/tree/main
|
|
107
|
+
bug_tracker_uri: https://github.com/idhra/solana-ruby-watchtower/issues
|
|
108
|
+
changelog_uri: https://github.com/idhra/solana-ruby-watchtower/blob/main/CHANGELOG.md
|
|
109
|
+
rubygems_mfa_required: 'true'
|
|
110
|
+
rdoc_options: []
|
|
111
|
+
require_paths:
|
|
112
|
+
- lib
|
|
113
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
|
114
|
+
requirements:
|
|
115
|
+
- - ">="
|
|
116
|
+
- !ruby/object:Gem::Version
|
|
117
|
+
version: 3.2.0
|
|
118
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
119
|
+
requirements:
|
|
120
|
+
- - ">="
|
|
121
|
+
- !ruby/object:Gem::Version
|
|
122
|
+
version: '0'
|
|
123
|
+
requirements: []
|
|
124
|
+
rubygems_version: 3.6.9
|
|
125
|
+
specification_version: 4
|
|
126
|
+
summary: Off-box monitor for Solana validators, including active/standby HA pairs
|
|
127
|
+
test_files: []
|