Environment Info

Runtime introspection & diagnostics for OutSystems applications.

v1.3.0 

Environment Info is a utility extension for OutSystems that exposes server-side environment and runtime details to your application logic. It surfaces information the built-in System module doesn't readily provide — server mode, environment name/key, DNS hostname, Front-End identity, originating client IP, and a full server runtime snapshot — by interfacing directly with the OutSystems.HubEdition.RuntimePlatform and .NET runtime APIs.

Typical uses: environment-aware feature flags, richer diagnostic logging, request auditing, and support tooling.

Features

• Environment detection — Identify whether code is running in Production or a non-Production environment with a single boolean check.
• Dynamic mode listing — Retrieve the complete list of server modes supported by the platform, generated at runtime so it stays accurate across platform versions.
• Hostname resolution — Read the configured default DNS name for the environment, even from background contexts.
• Environment information — Obtain the environment's display name and unique key identifier.
• Front-End identification — Determine which Front-End server is handling the current request.
• Client IP detection — Capture the originating client IP of a request, correctly resolved behind load balancers and reverse proxies.
• Runtime diagnostics — Inspect the server's .NET framework, operating system, machine name, and hardware details.

Server Actions

Quick reference — every action returns its data through output parameters only:

IsProductionEnvironment

Inputs: none · Returns: IsProductionEnvironment (Boolean)

Performs a quick boolean check to determine whether the current environment is running in Production mode. Ideal for use directly in If widgets and conditional logic — guarding test-data seeding, verbose logging, or non-Production-only behavior. Returns True only for Production; False for every other mode.

GetEnvironmentServerMode

Inputs: none · Returns: ServerMode (ServerMode structure)

Returns the current environment's server mode as a record containing its numeric Id and human-readable Name, read from the active AppInfo.

GetEnvironmentServerModes

Inputs: none · Returns: ServerModes (List of ServerMode)

Returns the complete set of server modes supported by the platform. The list is generated by iterating the platform's internal ServerModes enumeration, so it stays accurate as the platform evolves. Useful for populating dropdowns or mapping a mode Id to its name.

GetEnvironmentHostname

Inputs: none · Returns: Hostname (Text)

Returns the environment's configured default DNS hostname — for example env-dev.outsystemsenterprise.com — via EspaceProperties.DefaultDnsName. Resolves consistently even in non-HTTP contexts such as Timers and BPT processes, and returns an empty string when no DNS name is configured.

GetFrontEndName

Inputs: none · Returns: FrontEndName (Text)

Returns the network name of the specific Front-End server processing the current request. Primarily used for diagnostics, technical logging, and auditing — it lets you pinpoint exactly which Front-End handled a request in multi-server, load-balanced environments.

GetEnvironmentKey

Inputs: none · Returns: EnvironmentKey (Text)

Returns the unique key (GUID) that identifies the current running environment.

GetEnvironmentName

Inputs: none · Returns: EnvironmentName (Text)

Returns the display name of the current running environment.

GetClientIPAddress

Inputs: none · Returns: IPAddress (Text)

Returns the IP address of the client that issued the current request. The action inspects the X-Forwarded-For header first — recovering the true client IP when traffic passes through a load balancer or reverse proxy — and falls back to the direct connection address otherwise. Returns an empty string outside of an HTTP request (Timers, BPT, async logic).

Security note: The X-Forwarded-For header is supplied by the client and can be spoofed. Use this value for diagnostics, logging, and auditing — not as the sole basis for security decisions such as IP allow-listing or authentication.

GetRuntimeInfo

Inputs: none · Returns: RuntimeInfo (RuntimeInfo structure)

Returns a snapshot of the server runtime in a single structure — framework version, operating system, machine name, logical processor count, and process/OS bitness. Designed for support and environment diagnostics, letting you capture the full runtime profile in one call.

Structures

ServerMode

RuntimeInfo

Technical Dependencies

The extension relies only on platform and standard .NET assemblies — there are no third-party packages to manage.