logtail 0.1.13 → 0.1.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10c467039aa517fd668eb0b4f25a3bc0405331b9c422984b01e7effa7bfd1ceb
-  data.tar.gz: 2890f2588f6beb9671037e0521a3eb361e80937e0c475b4be2f2895e48422540
+  metadata.gz: 6576745c59d3a1051e33d2c80c72cb085657d1ac5d4ffdc3eddd25d453eb7ce0
+  data.tar.gz: dabb146bd9c0904bed8213745d027fc87844314fe792c591eacb917c6be66cd9
 SHA512:
-  metadata.gz: 81d0c6479082f302ff146cb321f9483c6b46a8d2fbf9133e1c661bc9694f5d8134447a2ec6d8ab7bfbc6ee36abc66fabe0777e113b199dc31642810fbfee7322
-  data.tar.gz: 161f16cd44e8522fe9c6e47b31773a2d422372ac082409d3afaec74ba249807af1a51512fcb1c151eb5541ad45cbbfc82d62eccde03231b25129abe0dfda232e
+  metadata.gz: 53ca720088be23dc6896413709c24d669afb1bf62297b6366467b4a36e912c153403ad8a38ab0edf134932c84893bc5bd5a02c76bc2b7a52e468b731474c89ed
+  data.tar.gz: ed3d8f6af7c41eee437253d6b510d76dd521c3b747791a7ef5049b59b47924da838e1e05395c4c8186e809119de4d6edaf0d0debde18652716f273933f9e97b7

data/.github/workflows/main.yml

@@ -15,18 +15,19 @@ jobs:
 
       matrix:
         ruby-version:
-          - 3.2
-          - 3.1
-          - 3.0
-          - 2.7
-          - 2.6
-          - 2.5
-          - 2.4
-          - 2.3
-          - jruby-9.4.3.0
-          - jruby-9.2.14.0
-          - truffleruby-23.0.0
-          - truffleruby-22.1.0
+          - "3"
+          - "3.4"
+          - "3.3"
+          - "3.2"
+          - "3.1"
+          - "3.0"
+          - "2.7"
+          - "2.6"
+          - "2.5"
+          - "jruby-9.4.3.0"
+          - "jruby-9.2.14.0"
+          - "truffleruby-23.0.0"
+          - "truffleruby-22.1.0"
 
     steps:
       - uses: actions/checkout@v2

data/Gemfile

@@ -8,3 +8,4 @@ gemspec
 gem "rake", "~> 13.0"
 
 gem "rspec", "~> 3.0"
+gem "base64" if RUBY_VERSION >= "3.4.0"

data/Rakefile

@@ -15,7 +15,7 @@ def puts_with_level(message, level = :info)
 end
 
 task :test_the_pipes, [:source_token] do |t, args|
-  support_email = "support@logtail.com"
+  support_email = "hello@betterstack.com"
   # Do not modify below this line. It's important to keep the `Logtail::Logger`
   # because it provides an API for logging structured data and capturing context.
   header = <<~HEREDOC
@@ -31,7 +31,7 @@ task :test_the_pipes, [:source_token] do |t, args|
   if response.is_a?(Exception)
     message = <<~HEREDOC
         Unable to deliver logs.
-        Here's what we received from the Logtail API:
+        Here's what we received from the Better Stack Telemetry API:
         #{response.inspect}
         If you continue to have trouble please contact support:
         #{support_email}
@@ -39,13 +39,13 @@ task :test_the_pipes, [:source_token] do |t, args|
     puts_with_level(message, :error)
   elsif response.is_a?(Net::HTTPResponse)
     if response.code.start_with? '2'
-      puts_with_level("Logs successfully sent! View them at https://logtail.com",
+      puts_with_level("Logs successfully sent! View them at https://telemetry.betterstack.com",
         :success)
     else
       message =
         <<~HEREDOC
         Unable to deliver logs.
-        We received a #{response.code} response from the Logtail API:
+        We received a #{response.code} response from the Better Stack Telemetry API:
         #{response.body.inspect}
         If you continue to have trouble please contact support:
         #{support_email}

data/example-project/Gemfile

@@ -1,2 +1,2 @@
 source 'https://rubygems.org'
-gem "logtail", "~> 0.1.12"
+gem "logtail", "~> 0.1.15"

data/example-project/Gemfile.lock

@@ -1,7 +1,7 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    logtail (0.1.12)
+    logtail (0.1.15)
       msgpack (~> 1.0)
     msgpack (1.7.2)
 
@@ -9,7 +9,7 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  logtail
+  logtail (~> 0.1.15)
 
 BUNDLED WITH
    2.1.4

data/example-project/README.md

@@ -15,13 +15,13 @@ This will install all dependencies listed in the `Gemfile.lock` file.
 Alternatively, add `gem "logtail"` to your `Gemfile` manually and then run `bundle install`.
 
  ## Run the example project
- 
- Replace `<source-token>` with your actual source token in the `main.rb` file. You can find your source token by going to _logtail.com -> sources -> edit_.
- 
+
+_Don't forget to replace `<source_token>` and `<ingesting_host>` with your actual source token and ingesting host which you can find by going to **[Sources](https://telemetry.betterstack.com/team/0/sources) -> Configure** in Better Stack._ 
+
  To run the example application, run the following command adding your source token:
 
 ```bash
-bundle exec ruby main.rb <source-token>
+bundle exec ruby main.rb <source_token> <ingesting_host>
 ```
 
 This will create a total of 5 different logs, each corresponding to a different log level. You can review these logs in Logtail.

data/example-project/main.rb

@@ -7,12 +7,12 @@
 require "logtail"
 
 # Check for program arguments
-if ARGV.length != 1
-    puts "Program needs source token to run. Run the program as followed\nbundle exec ruby main.rb <source-token>"
+if ARGV.length != 2
+    puts "Program needs source token and ingesting host to run. Run the program as followed\nbundle exec ruby main.rb <source_token> <ingesting_host>"
     exit
 end
 # Create logger
-http_device = Logtail::LogDevices::HTTP.new(ARGV[0])
+http_device = Logtail::LogDevices::HTTP.new(ARGV[0], ingesting_host: ARGV[1])
 logger = Logtail::Logger.new(http_device)
 
 # Filter logs that shouldn't be sent to Better Stack, see {Logtail::LogEntry} for available attributes
@@ -21,10 +21,10 @@ Logtail.config.filter_sent_to_better_stack { |log_entry| log_entry.message.inclu
 # LOGGING
 
 # Send debug logs messages using the debug() method
-logger.debug("Logtail is ready!")
+logger.debug("Better Stack is ready!")
 
 # Send informative messages about interesting events using the info() method
-logger.info("I am using Logtail!")
+logger.info("I am using Better Stack!")
 
 # Send messages about worrying events using the warn() method
 # You can also log additional structured data

data/lib/logtail/log_devices/http.rb

@@ -17,11 +17,9 @@ module Logtail
     #
     # See {#initialize} for options and more details.
     class HTTP
-      LOGTAIL_STAGING_HOST = "in.logtail.dev".freeze
-      LOGTAIL_PRODUCTION_HOST = "in.logtail.com".freeze
-      LOGTAIL_HOST = ENV['LOGTAIL_STAGING'] ? LOGTAIL_STAGING_HOST : LOGTAIL_PRODUCTION_HOST
-      LOGTAIL_PORT = 443
-      LOGTAIL_SCHEME = "https".freeze
+      DEFAULT_INGESTING_HOST = "in.logs.betterstack.com".freeze
+      DEFAULT_INGESTING_PORT = 443
+      DEFAULT_INGESTING_SCHEME = "https".freeze
       CONTENT_TYPE = "application/msgpack".freeze
       USER_AGENT = "Logtail Ruby/#{Logtail::VERSION} (HTTP)".freeze
 
@@ -36,15 +34,15 @@ module Logtail
       # you can drop the log messages instead by passing a {DroppingSizedQueue} via the
       # `:request_queue` option.
       #
-      # @param source_token [String] The API key provided to you after you add your application to
-      #   [Logtail](https://logtail.com).
+      # @param source_token [String] The API key provided to you after you add your source to
+      #   [Better Stack](https://telemetry.betterstack.com).
       # @param [Hash] options the options to create a HTTP log device with.
       # @option attributes [Symbol] :batch_size (1000) Determines the maximum of log lines in
       #   each HTTP payload. If the queue exceeds this limit an HTTP request will be issued. Bigger
       #   payloads mean higher throughput, but also use more memory. Logtail will not accept
       #   payloads larger than 1mb.
       # @option attributes [Symbol] :flush_continuously (true) This should only be disabled under
-      #   special circumstsances (like test suites). Setting this to `false` disables the
+      #   special circumstances (like test suites). Setting this to `false` disables the
       #   continuous flushing of log message. As a result, flushing must be handled externally
       #   via the #flush method.
       # @option attributes [Symbol] :flush_interval (1) How often the client should
@@ -55,25 +53,30 @@ module Logtail
       #   single persistent connection. After this number is met, the connection will be closed
       #   and a new one will be opened.
       # @option attributes [Symbol] :request_queue (FlushableDroppingSizedQueue.new(25)) The request
-      #   queue object that queues Net::HTTP requests for delivery. By deafult this is a
+      #   queue object that queues Net::HTTP requests for delivery. By default this is a
       #   `FlushableDroppingSizedQueue` of size `25`. Meaning once the queue fills up to 25
       #   requests new requests will be dropped. If you'd prefer to apply back pressure,
       #   ensuring you do not lose log data, pass a standard {SizedQueue}. See examples for
       #   an example.
-      # @option attributes [Symbol] :logtail_host The Logtail host to delivery the log lines to.
-      #   The default is set via {LOGTAIL_HOST}.
+      # @option attributes [Symbol] :ingesting_host The Better Stack Telemetry ingesting host to delivery the log lines to.
+      #   The default is set via {INGESTING_HOST}.
       #
       # @example Basic usage
-      #   Logtail::Logger.new(Logtail::LogDevices::HTTP.new("my_logtail_source_token"))
+      #   Logtail::Logger.new(Logtail::LogDevices::HTTP.new("<source_token>", ingesting_host: "<ingesting_host>"))
       #
       # @example Apply back pressure instead of dropping messages
-      #   http_log_device = Logtail::LogDevices::HTTP.new("my_logtail_source_token", request_queue: SizedQueue.new(25))
+      #   http_log_device = Logtail::LogDevices::HTTP.new("<source_token>", ingesting_host: "<ingesting_host>", request_queue: SizedQueue.new(25))
       #   Logtail::Logger.new(http_log_device)
       def initialize(source_token, options = {})
+        # Handle backward-compatibility of argument names
+        options[:ingesting_host] ||= options[:logtail_host]
+        options[:ingesting_port] ||= options[:logtail_port]
+        options[:ingesting_scheme] ||= options[:logtail_scheme]
+
         @source_token = source_token || raise(ArgumentError.new("The source_token parameter cannot be blank"))
-        @logtail_host = options[:logtail_host] || ENV['LOGTAIL_HOST'] || LOGTAIL_HOST
-        @logtail_port = options[:logtail_port] || ENV['LOGTAIL_PORT'] || LOGTAIL_PORT
-        @logtail_scheme = options[:logtail_scheme] || ENV['LOGTAIL_SCHEME'] || LOGTAIL_SCHEME
+        @ingesting_host = options[:ingesting_host] || ENV['INGESTING_HOST'] || ENV['LOGTAIL_HOST'] || DEFAULT_INGESTING_HOST
+        @ingesting_port = options[:ingesting_port] || ENV['INGESTING_PORT'] || ENV['LOGTAIL_PORT'] || DEFAULT_INGESTING_PORT
+        @ingesting_scheme = options[:ingesting_scheme] || ENV['INGESTING_SCHEME'] || ENV['LOGTAIL_SCHEME'] || DEFAULT_INGESTING_SCHEME
         @batch_size = options[:batch_size] || 1_000
         @flush_continuously = options[:flush_continuously] != false
         @flush_interval = options[:flush_interval] || 2 # 2 seconds
@@ -153,7 +156,7 @@ module Logtail
           if @last_resp.nil?
             print "."
           elsif @last_resp.code == "202"
-            puts "Log delivery successful! View your logs at https://logtail.com"
+            puts "Log delivery successful! View your logs at https://telemetry.betterstack.com"
           else
             raise <<-MESSAGE
 
@@ -282,9 +285,9 @@ MESSAGE
 
         # Builds an `Net::HTTP` object to deliver requests over.
         def build_http
-          http = Net::HTTP.new(@logtail_host, @logtail_port)
+          http = Net::HTTP.new(@ingesting_host, @ingesting_port)
           http.set_debug_output(Config.instance.debug_logger) if Config.instance.debug_logger
-          if @logtail_scheme == 'https'
+          if @ingesting_scheme == 'https'
             http.use_ssl = true
             # Verification on Windows fails despite having a valid certificate.
             http.verify_mode = OpenSSL::SSL::VERIFY_NONE
@@ -360,7 +363,7 @@ MESSAGE
 
               Logtail::Config.instance.debug do
                 if resp.code == "202"
-                  "Logs successfully sent! View your logs at https://logtail.com"
+                  "Logs successfully sent! View your logs at https://telemetry.betterstack.com"
                 else
                   "Log delivery failed! status: #{resp.code}, body: #{resp.body}"
                 end

data/lib/logtail/log_entry.rb

@@ -16,7 +16,7 @@ module Logtail
 
     attr_reader :context_snapshot, :event, :level, :message, :progname, :tags, :time
 
-    # Creates a log entry suitable to be sent to the Logtail API.
+    # Creates a log entry suitable to be sent to the Better Stack Telemetry API.
     # @param level [Integer] the log level / severity
     # @param time [Time] the exact time the log message was written
     # @param progname [String] the progname scope for the log message

data/lib/logtail/version.rb

@@ -1,3 +1,3 @@
 module Logtail
-  VERSION = "0.1.13"
+  VERSION = "0.1.15"
 end

data/spec/logtail/log_devices/http_spec.rb

@@ -125,7 +125,7 @@ describe Logtail::LogDevices::HTTP do
     let(:time) { Time.utc(2016, 9, 1, 12, 0, 0) }
 
     it "should deliver requests on an interval" do
-      stub = stub_request(:post, "https://in.logtail.com/").
+      stub = stub_request(:post, "https://in.logs.betterstack.com/").
         with(
           :body => start_with("\x92\x84\xA5level\xA4INFO\xA2dt\xBB2016-09-01T12:00:00.000000Z\xA7message\xB2test log message 1".force_encoding("ASCII-8BIT")),
           :headers => {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logtail
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.1.15
 platform: ruby
 authors:
 - Better Stack
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-14 00:00:00.000000000 Z
+date: 2025-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: msgpack