Documentation

Documentation

    ›Session Configuration

    General

    • Getting Started
    • Use Cases
    • Setup Guide

    Tutorials

    • Containerized Java

    SDK Setup

    • Introduction
    • JVM
    • .NET
    • Python
    • Ruby
    • Node.js
    • Go
    • Deployment Examples

    Session Configuration

    • Instances Selection
    • Source Code
    • Labels

    Breakpoints

    • Introduction
    • Breakpoint Status
    • Conditional Breakpoints
    • Breakpoint Limits
    • Built-in Variables

    Organizations

    • Organizations

    ETL Controller

    • Introduction
    • Installation
    • Configuration

    Data On-Premise

    • Introduction
    • Installation
    • Configuration

    Advanced

    • Live Logger
    • Collaboration
    • Tracing Timeline
    • Keyboard Shortcuts
    • Data Redaction

    More

    • Software Versions
    • Controller and Datastore License
    Edit

    Labels

    Labels are key/value pairs that are attached to running application instances.

    Labels can be used to organize and select groups of application instances. In this example organization, there are three environments - development, staging, and production with 4 different services in each environment.

    Setting up your Rookout deployment

    When installing the Rookout SDK, you may provide the service name and environment name as labels.
    For example, service #3 in Production may be configured using the following:

    Python
    Node
    JVM
    .NET
    rook.start(token='[Your Rookout Token]',
    labels={"service":"service#3","env":"dev"})
    rook.start({
    token: '[Your Rookout Token]',
    labels:
    {
    "service":"service#3",
    "env":"dev"
    }

    });
    # Export your labels as an environment variable
    export ROOKOUT_LABELS=service:service3,env:dev
    Rook.RookOptions options = new Rook.RookOptions() 
    {
    token = "[Your Rookout Token]",
    labels = new Dictionary<string, string> { { "service", "service#3" }, { "env", "dev" } }
    };
    Rook.API.Start(options);

    Altenatively, labels can be added as environment variables in Python and Node as well:

    export ROOKOUT_LABELS='service:service3,env:dev'
    

    Examples

    Debug all instances of specific service

    When creating your Rookout Project, use the following filter to debug all instances of service #3 (in Production, Staging and Dev).

    1. Add the following filter: service:service#3

    2. Import the source code for service #3.

    Debug all instances in specific environment

    When creating your Rookout Project, use the following filter to debug only instances running in Production.

    1. Add the following filter: env:production

    2. Import the source code of the relevant service.

    Debug specific instance in specific enviroment

    To refine the filter, you may use the following filter to debug only the instance of service #3 running in Staging.

    1. Add the following filters: env:staging service:service#3

    2. Import the source code for service #3.

    ← Source CodeIntroduction →
    • Examples
      • Debug all instances of specific service
      • Debug all instances in specific environment
      • Debug specific instance in specific enviroment
    General

    WelcomeUse CasesSetup Guide
    Tutorials

    Java Container Tutorial
    SDK Setup

    Setup IntroJvm SetupDotnet SetupPython SetupRuby SetupNode SetupGo SetupDeployment Examples
    Session Configuration

    Debug Session SetupSource ReposProjects Labels
    Breakpoints

    BreakpointsBreakpoints StatusBreakpoints ConditionalBreakpoint LimitsBuilt In Variables
    Organizations

    Organizations
    ETL Controller

    Etl Controller IntroEtl Controller InstallEtl Controller Config
    Data On-Premise

    Dop IntroDop InstallDop Config
    Advanced

    Live LoggerCollaborationsTracing TimelineKeyboard ShortcutsData Redaction
    More

    Sdk DigestsLicense
    Other

    Status
    GitHub - RookoutFacebook - RookoutTwitter - RookoutLinkedIn - Rookout