logtail 0.1.13 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10c467039aa517fd668eb0b4f25a3bc0405331b9c422984b01e7effa7bfd1ceb
-  data.tar.gz: 2890f2588f6beb9671037e0521a3eb361e80937e0c475b4be2f2895e48422540
+  metadata.gz: 6cb9ce58d42f8eaae77256309904b1e1f1d34974ffb2baf9d08b3ae8f9bc9add
+  data.tar.gz: cee900d3422c3d51c4b5915b54281c7b4522e1ae49c14e72820539080b013870
 SHA512:
-  metadata.gz: 81d0c6479082f302ff146cb321f9483c6b46a8d2fbf9133e1c661bc9694f5d8134447a2ec6d8ab7bfbc6ee36abc66fabe0777e113b199dc31642810fbfee7322
-  data.tar.gz: 161f16cd44e8522fe9c6e47b31773a2d422372ac082409d3afaec74ba249807af1a51512fcb1c151eb5541ad45cbbfc82d62eccde03231b25129abe0dfda232e
+  metadata.gz: 8d7fa9ab0b8ed9b7cb23d5a940485bc523037c31134f68a6a0e9adf91190ef22284008e650b95406d1bb76834744d889569dab81943b3af0ebc69fdda73519a7
+  data.tar.gz: 20d6428149c7e2f0687cc0c0af867f16ff1f495c7622b49afef8e661f83900c31c46a00b322e9f15510202f877d70d17196c0163efbfd460b03a2fa8a881e4f5

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.14"

data/example-project/Gemfile.lock

@@ -1,7 +1,7 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    logtail (0.1.12)
+    logtail (0.1.14)
       msgpack (~> 1.0)
     msgpack (1.7.2)
 
@@ -9,7 +9,7 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  logtail
+  logtail (~> 0.1.14)
 
 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,13 +17,11 @@ 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
+      USER_AGENT = "Better Stack Telemetry for Ruby/#{Logtail::VERSION} (HTTP)".freeze
 
       # Instantiates a new HTTP log device that can be passed to {Logtail::Logger#initialize}.
       #
@@ -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[:ingesting_host] if options[:ingesting_host].present?
+        options[:ingesting_port] ||= options[:logtail_port] if options[:logtail_port].present?
+        options[:ingesting_scheme] ||= options[:logtail_scheme] if options[:logtail_scheme].present?
+
         @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.14"
 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.14
 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