Enhance Logtail logger configuration in application.rb with detailed logging and error handling for missing environment variables

Author: Shpigford

config/application.rb

@@ -27,8 +27,30 @@ class Application < Rails::Application
     # config.eager_load_paths << Rails.root.join("extras")
     config.active_support.to_time_preserves_timezone = :zone
 
-    if ENV["LOGTAIL_API_KEY"].present? && ENV["LOGTAIL_INGESTING_HOST"].present?
-      config.logger = Logtail::Logger.create_default_logger(ENV["LOGTAIL_API_KEY"], ingesting_host: ENV["LOGTAIL_INGESTING_HOST"])
-    end
+        if ENV["LOGTAIL_API_KEY"].present? && ENV["LOGTAIL_INGESTING_HOST"].present?
+      begin
+        puts "🌲 Configuring Logtail..."
+        puts "   API Key: #{ENV['LOGTAIL_API_KEY'] ? 'Present' : 'Missing'}"
+        puts "   Ingesting Host: #{ENV['LOGTAIL_INGESTING_HOST']}"
+
+        config.logger = Logtail::Logger.create_default_logger(
+          ENV["LOGTAIL_API_KEY"],
+          ingesting_host: ENV["LOGTAIL_INGESTING_HOST"]
+        )
+
+        puts "✅ Logtail logger configured successfully"
+      rescue => e
+        puts "❌ Failed to configure Logtail: #{e.message}"
+        puts "   Backtrace: #{e.backtrace.first(3).join(', ')}"
+        puts "   Using standard Rails logger instead"
+        # Fall back to standard Rails logger
+        config.logger = ActiveSupport::Logger.new(STDOUT)
+      end
+        else
+      missing_vars = []
+      missing_vars << "LOGTAIL_API_KEY" unless ENV["LOGTAIL_API_KEY"].present?
+      missing_vars << "LOGTAIL_INGESTING_HOST" unless ENV["LOGTAIL_INGESTING_HOST"].present?
+      puts "⚠️  Logtail not configured. Missing environment variables: #{missing_vars.join(', ')}"
+        end
   end
 end

config/initializers/debug_logtail_threads.rb

@@ -0,0 +1,40 @@
+# Temporary debug initializer for Logtail thread monitoring
+# Remove this file once the issue is resolved
+
+Rails.application.config.after_initialize do
+  if defined?(Logtail) && Rails.logger.is_a?(Logtail::Logger)
+    puts "🔍 Monitoring Logtail threads after Rails initialization..."
+
+    # Check for Logtail threads
+    logtail_threads = Thread.list.select do |thread|
+      thread.backtrace_locations&.any? { |loc| loc.path.include?("logtail") }
+    end
+
+    if logtail_threads.any?
+      puts "   Found #{logtail_threads.count} Logtail threads:"
+      logtail_threads.each_with_index do |thread, i|
+        puts "   Thread #{i + 1}: #{thread.status} - #{thread.backtrace_locations&.first}"
+      end
+
+      # Schedule a thread check after 10 seconds
+      Thread.new do
+        sleep 10
+        puts "🔍 Thread status after 10 seconds:"
+        logtail_threads.each_with_index do |thread, i|
+          if thread.alive?
+            puts "   Thread #{i + 1}: #{thread.status}"
+            if thread.status == "sleep"
+              puts "     ⚠️  Thread is sleeping - possible connectivity issue"
+            end
+          else
+            puts "   Thread #{i + 1}: ❌ Dead"
+          end
+        end
+      end
+    else
+      puts "   ✅ No Logtail threads found"
+    end
+  else
+    puts "⚠️  Logtail logger not configured or not detected"
+  end
+end

debug_logtail.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'logtail-rails'
+require 'dotenv'
+
+# Load environment variables if using .env file
+Dotenv.load if defined?(Dotenv)
+
+puts "🔍 Debugging Logtail Configuration"
+puts "=================================="
+
+# Check environment variables
+api_key = ENV["LOGTAIL_API_KEY"]
+ingesting_host = ENV["LOGTAIL_INGESTING_HOST"]
+
+puts "Environment Variables:"
+puts "  LOGTAIL_API_KEY: #{api_key ? "Present (#{api_key[0..8]}...)" : "❌ Missing"}"
+puts "  LOGTAIL_INGESTING_HOST: #{ingesting_host || "❌ Missing"}"
+puts
+
+if api_key.nil? || ingesting_host.nil?
+  puts "❌ Missing required environment variables. Common values:"
+  puts "   LOGTAIL_INGESTING_HOST should be:"
+  puts "   - https://in.logs.betterstack.com (US)"
+  puts "   - https://in.logs.eu.betterstack.com (EU)"
+  exit 1
+end
+
+# Test basic connectivity
+puts "🌐 Testing Network Connectivity to #{ingesting_host}..."
+begin
+  require 'net/http'
+  require 'uri'
+
+  uri = URI(ingesting_host)
+  response = Net::HTTP.get_response(uri)
+  puts "   Status: #{response.code} #{response.message}"
+rescue => e
+  puts "   ❌ Network Error: #{e.message}"
+  puts "   This could explain why Logtail threads are stuck!"
+end
+
+puts
+
+# Test Logtail logger creation
+puts "🧪 Testing Logtail Logger Creation..."
+begin
+  logger = Logtail::Logger.create_default_logger(api_key, ingesting_host: ingesting_host)
+  puts "   ✅ Logger created successfully"
+
+  puts "🧪 Testing Log Message..."
+  logger.info("Test message from debug script", { test: true, timestamp: Time.now })
+  puts "   ✅ Log message sent"
+
+  puts "🧪 Closing logger to flush messages..."
+  logger.close
+  puts "   ✅ Logger closed"
+
+rescue => e
+  puts "   ❌ Error: #{e.message}"
+  puts "   Backtrace:"
+  e.backtrace.first(5).each { |line| puts "     #{line}" }
+end
+
+puts
+puts "✅ Debug complete. Check your Better Stack dashboard for the test message."