Subchapter 145.7

Ruby

references/ruby.mdMarkdown19 KBView on GitHub

Ruby - Docs

The posthog-ruby library provides tracking functionality on the server-side for applications built in Ruby.

It uses an internal queue to make calls fast and non-blocking. It also batches requests and flushes asynchronously, making it perfect to use in any part of your web app or other server-side application that needs performance.

Ruby · Integration Ruby · PostHog/skills · Skills Docs

is_my_flag_enabled = posthog.is_feature_enabled('flag-key', 'distinct_id_of_your_user')
if is_my_flag_enabled
    # Do something differently for this user
    # Optional: fetch the payload
    matched_flag_payload = posthog.get_feature_flag_payload('flag-key', 'distinct_id_of_your_user')
end

enabled_variant = posthog.get_feature_flag('flag-key', 'distinct_id_of_your_user')
if enabled_variant == 'variant-key' # replace 'variant-key' with the key of your variant
    # Do something differently for this user
    # Optional: fetch the payload
    matched_flag_payload = posthog.get_feature_flag_payload('variant-key', 'distinct_id_of_your_user')
end

posthog.capture({
    distinct_id: 'distinct_id_of_your_user',
    event: 'event_name',
    properties: {
        '$feature/feature-flag-key': 'variant-key', # replace feature-flag-key with your flag key. Replace 'variant-key' with the key of your variant
    }
})

posthog.capture({
    distinct_id: 'distinct_id_of_your_user',
    event: 'event_name',
    send_feature_flags: {
        only_evaluate_locally: true,
        person_properties: { plan: 'premium' },
        group_properties: { org: { tier: 'enterprise' } }
    }
})

posthog.get_feature_flag(
    'flag-key',
    'distinct_id_of_the_user',
    person_properties: {
        'property_name': 'value'
    },
    groups: {
        'your_group_type': 'your_group_id',
        'another_group_type': 'your_group_id',
    },
    group_properties: {
        'your_group_type': {
            'group_property_name': 'value'
        }
        'another_group_type': {
            'group_property_name': 'value'
        }
    },
)

def handle_feature_flag(client, flag_key, distinct_id)
    begin
        is_enabled = client.is_feature_enabled(flag_key, distinct_id)
        puts "Feature flag '#{flag_key}' for user '#{distinct_id}' is #{is_enabled ? 'enabled' : 'disabled'}"
        return is_enabled
    rescue => e
        puts "Error fetching feature flag '#{flag_key}': #{e.message}"
        # Optionally, you can return a default value or throw the error
        # return false # Default to disabled
        raise e
    end
end
# Usage example
try
    flag_enabled = handle_feature_flag(client, 'new-feature', 'user-123')
    if flag_enabled
        # Implement new feature logic
    else
        # Implement old feature logic
    end
rescue => e
    # Handle the error at a higher level
    puts 'Feature flag check failed, using default behavior'
    # Implement fallback logic
end

after_fork do |server, worker|
  $posthog = PostHog::Client.new(
    api_key: '<ph_project_token>',
    personal_api_key: '<ph_personal_api_key>'
    host: 'https://us.i.posthog.com',
    on_error: Proc.new { |status, msg| print msg }
  )
end

on_worker_boot do
  $posthog = PostHog::Client.new(
    api_key: '<ph_project_token>',
    personal_api_key: '<ph_personal_api_key>'
    host: 'https://us.i.posthog.com',
    on_error: Proc.new { |status, msg| print msg }
  )
end

posthog.capture({
    distinct_id: 'distinct_id_of_the_user',
    event: 'movie_played',
    properties: {
        movie_id: '123',
        category: 'romcom'
    }
    groups: {
        'company': 'company_id_in_your_db'
    }
})

begin
  # Code that might raise an exception
  raise StandardError, "Something went wrong"
rescue => e
  posthog.capture_exception(
    e,
    distinct_id: 'user_distinct_id',
    properties: {
      custom_property: 'custom_value'
    }
  )
end

Parameter	Type	Description
exception	Exception	The exception object to capture (required)
distinct_id	String	The distinct ID of the user (optional)
properties	Hash	Additional properties to attach to the exception event (optional)

Ruby

Ruby - Docs

Ruby

Ruby - Docs

Identifying users

Capturing events

Setting event properties

Sending pageviews

Person profiles and properties

Alias

Feature flags

Step 1: Evaluate the feature flag value

Boolean feature flags

Multivariate feature flags

Step 2: Include feature flag information when capturing events

Method 1: Include the `$feature/feature_flag_name` property

Method 2: Set `send_feature_flags` to `true`

Basic usage

Advanced usage (v3.1.0+)

Performance considerations

Breaking change in v3.1.0

Fetching all flags for a user

Sending `$feature_flag_called` events

Advanced: Overriding server properties

Overriding GeoIP properties

Request timeout

Error handling

Local Evaluation

Evaluating feature flags locally in unicorn server

Evaluating feature flags locally in a Puma server

Experiments (A/B tests)

Group analytics

Exception capture

Debug mode

Thank you

Community questions

Was this page useful?