Configure GermainUX’s Application Monitoring for Oracle Siebel CRM
⚙️ Configure Application Monitoring for Oracle Siebel CRM
This guide explains how to configure essential health and performance monitoring for the Siebel Enterprise, Gateway, Application Servers, Object Managers, logs, crash files, tasks, processes, HTTP, and SISNAPI services.
GermainUX includes preconfigured Siebel parsers, monitors, metrics, KPIs, and dashboards based on more than 20 years of Siebel monitoring experience. These configurations can be adjusted to match each Siebel version, architecture, component model, and operational requirement.
▶️ Recommended implementation order
Configure Siebel monitoring in this order:
|
Action |
|
|---|---|
|
1 |
Create a synthetic scenario for a critical workflow. |
|
2 |
Import or verify the Siebel component types. |
|
3 |
Add the Siebel servers. |
|
4 |
Add the monitoring credentials. |
|
5 |
Configure task- and process-level monitoring. |
|
6 |
Configure Object Manager and Server Manager parsers. |
|
7 |
Configure log, crash, and Gateway directory monitors. |
|
8 |
Configure remote Siebel component monitoring. |
|
9 |
Configure the Siebel Config Collator. |
|
10 |
Configure HTTP and SISNAPI availability monitoring. |
|
11 |
Exclude components that should not be monitored. |
|
12 |
Validate the preconfigured KPIs and dashboards. |
|
13 |
Configure SLAs and alerts. |
Synthetic monitoring should be implemented early because it provides immediate confirmation that users can access and complete critical Siebel workflows. Server-side monitoring can then identify the component responsible when a synthetic test fails.
📋 Prerequisites
Before configuring Siebel application monitoring, confirm that:
|
Requirement |
|---|
|
A GermainUX Engine is deployed and online. |
|
The Engine can reach the Siebel servers. |
|
The Engine can access the Siebel Gateway. |
|
The Engine can execute the required Server Manager commands. |
|
The Engine service account can read the configured logs and diagnostic files. |
|
The Siebel Enterprise, Gateway, servers, and components are known. |
|
Appropriate monitoring credentials are available. |
|
Server paths are accessible from the Engine. |
|
Required WMI or SSH connectivity is available. |
|
Firewalls, proxies, DNS, and certificates have been configured. |
|
The monitoring thresholds have been reviewed with the Siebel operations team. |
See Engine Deployment for Oracle Siebel CRM.
✨ Open the Siebel wizards
In GermainUX, go to:
Workspace -> Left Menu → Settings > Wizards -> <search for Siebel or whichever keyword related to what you need>
The available wizards can include:
|
Wizard |
|---|
|
Siebel App Server |
|
Siebel Gateway Server |
|
Siebel OpenUI |
|
Siebel Web Server |
|
Parser |
|
Directory Monitor |
Use the wizard corresponding to the layer being configured.
🔧 Verify the Siebel component types
A new deployment requires the preconfigured Siebel seed data.
Current GermainUX deployments normally include this configuration. For an older or manually installed deployment, import the JSON files found under:
Server Distribution/configuration/siebel
Import them through the REST client in the GermainUX Configuration Console and select Merge so existing customizations are preserved.
Verify that these component types exist under:
germain.apm.monitoringConfig.components
Required component types include:
|
Component type |
|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Do not reimport the seed data into an established environment without first reviewing existing customizations and taking a configuration backup.
🖥️ Add the Siebel Application Server
Go to:
Workspace -> Left Menu -> Settings -> Wizards -> Siebel App Server
Create an entry for each Siebel Application Server that will be monitored.
Provide the requested information, including:
|
Field |
|---|
|
Server name |
|
Hostname or address |
|
Operating system |
|
Siebel Enterprise |
|
Siebel Gateway |
|
Siebel installation path |
|
Application or environment |
|
Assigned GermainUX Engine |
|
Monitoring credentials |
Use consistent names across Siebel, GermainUX, infrastructure monitoring, and operational documentation.
🔑 Add monitoring credentials
Create a stored credential for the Siebel server and Server Manager connection.
Use the GermainUX credential-management interface and provide, as applicable:
|
Field |
|---|
|
Username |
|
Password |
|
Domain |
|
Secure key |
|
Authentication type
|
Older deployments commonly use SADMIN, but a dedicated least-privilege monitoring account is recommended. Grant only the permissions required to retrieve Server Manager information and perform the configured availability checks.
Do not place usernames or passwords directly in scripts or monitor configuration fields.
👀 Configure task-level monitoring
Task-level monitoring provides visibility into the individual tasks and processes running within each Siebel component.
Without this information, teams may detect that a server or Enterprise is degraded but have insufficient evidence to identify the responsible component or task. This can result in unnecessary Enterprise-wide restarts.
Task monitoring should provide:
|
Metric |
|---|
|
Component run state |
|
Number of running tasks |
|
Maximum configured tasks |
|
Task utilization percentage |
|
Number of active multithreaded-server processes |
|
Maximum multithreaded-server processes |
|
Task utilization per process |
|
Task identifiers and states |
📈 Recommended initial thresholds
The following values are starting recommendations. Adjust them for the Siebel version, architecture, component purpose, workload, and expected operating state.
|
Siebel component |
Acceptable |
|
|
|---|---|---|---|
|
|
Running or Shutdown |
Not applicable |
|
|
|
Running or Shutdown |
Not applicable |
|
|
|
Running, Shutdown, or Online |
Less than 95% of |
|
|
|
Running, Shutdown, or Online |
Less than 95% of |
|
|
|
Running, Shutdown, or Online |
Less than 95% of |
|
|
|
Running or Shutdown |
Equal to |
|
|
|
Running or Shutdown |
Equal to |
Not applicable |
|
Other Siebel components |
Running, Shutdown, or Online |
Less than 95% of |
|
Review and approve the final SLA thresholds with the Siebel application and operations owners before enabling production alerts.
⚙️ Task metrics rule
The preconfigured rule is available under:
Workspace > Analytics > Rules > siebel-app-monitor-drl > Component Task Metrics
It generates the following metrics:
|
Metric type |
Description |
|---|---|
|
|
Number of running tasks for the component |
|
|
Percentage of the component’s maximum tasks currently running |
|
|
Average number of running tasks per active process |
|
|
Maximum configured tasks per process |
|
|
Percentage of the per-process task capacity in use |
|
|
Number of active multithreaded-server processes |
|
|
Percentage of the maximum multithreaded-server processes currently active |
The metrics retain task details such as server, component alias, component group, task ID, process ID, state, run mode, timestamps, status, parent task, label, and task type.
Customize the rule only when the standard task calculations do not match the organization’s Siebel configuration.
📁 Configure the Object Manager parser
The Object Manager parser processes Siebel component logs.
Go to:
Workspace > Settings > Wizards > Parser
Configure:
|
Field |
Value |
|---|---|
|
Monitoring node |
Select the applicable monitoring node |
|
Engine |
Select the Engine assigned to the Siebel server |
|
Parser component type |
|
|
Monitored application |
|
|
Monitored application component |
Leave empty unless a specific component assignment is required |
|
Number of instances |
|
For English-language Siebel logs, set the parser resource file to:
/com/germainsoftware/apm/localization/parser-siebel-objmgr-enu.properties
Use the corresponding localized resource file when processing logs written in another supported language.
🗃️ Configure the Server Manager parser
The Server Manager parser processes the output collected from Siebel Enterprise Manager or Server Manager.
Go to:
Workspace > Settings > Wizards > Parser
Configure:
|
Field |
Value |
|---|---|
|
Monitoring node |
Select the applicable monitoring node |
|
Engine |
Select the Engine assigned to the Siebel environment |
|
Parser component type |
|
|
Monitored application |
|
|
Monitored application component |
Leave empty unless a specific assignment is required |
|
Number of instances |
|
For English-language output, configure:
/com/germainsoftware/apm/localization/parser-siebel-em-enu.properties
Review the configuration and submit it.
📜 Configure Siebel log monitoring
Go to:
Workspace > Settings > Wizards > Directory Monitor
Configure the log directory monitor:
|
Field |
Recommended value |
|---|---|
|
Directory component type |
|
|
Name |
|
|
Monitored server |
The previously created Siebel server |
|
Path to monitor |
Location of the Siebel log files, accessible from the Engine |
|
Watch subdirectories |
|
|
Process existing files |
|
|
Process empty files |
|
|
Force polling |
|
|
Polling interval |
|
Although older interfaces may label the polling interval in seconds, the documented value 300000 is in milliseconds.
If processing existing files would ingest a large historical volume, initially limit the file scope or disable historical processing.
💥 Configure crash-file monitoring
Go to:
Workspace > Settings > Wizards > Directory Monitor
Configure:
|
Field |
Recommended value |
|---|---|
|
Directory component type |
|
|
Name |
|
|
Monitored server |
The previously created Siebel server |
|
Path to monitor |
Location of Siebel crash and core files |
|
Watch subdirectories |
|
|
Process existing files |
|
|
Process empty files |
|
|
Force polling |
|
|
Polling interval |
|
Confirm that the Engine service account can read the crash directory and that storage-retention policies prevent diagnostic files from consuming excessive disk space.
🔗 Configure Gateway monitoring
The Siebel Enterprise configuration is stored in siebns.dat. Monitor this file to detect and analyze Gateway configuration changes.
Go to:
Workspace > Settings > Wizards > Directory Monitor
Configure:
|
Field |
Recommended value |
|---|---|
|
Directory component type |
|
|
Name |
|
|
Monitored server |
The Siebel Gateway server |
|
Path to monitor |
Directory containing |
|
Watch subdirectories |
|
|
Process existing files |
|
|
Process empty files |
|
|
Force polling |
|
|
Polling interval |
|
Verify that the configured path points to the active Gateway configuration rather than an obsolete copy or backup.
📡 Configure remote Siebel component monitoring
Use the operating-system-appropriate component monitor:
|
OS |
Component |
|---|---|
|
Windows |
|
|
Unix or Linux |
|
Configure:
|
Field |
Recommended value |
|---|---|
|
Name |
|
|
Monitored server |
The previously created Siebel server |
|
Monitored application |
|
|
Credentials |
The stored Siebel monitoring credential |
|
Interval |
|
|
Local WMI connection |
|
|
Component type |
|
Add the following references to the component deployment:
|
Reference |
Value |
|---|---|
|
|
Reference to the stored Siebel credential |
|
|
Siebel Gateway hostname |
|
|
Reference to the configured Siebel server |
|
|
Siebel Enterprise name |
|
|
Siebel installation path, such as |
|
|
Optional comma-separated list of components to exclude |
For example:
SiebelGateway = gcgsiebel77
SiebelEnterprise = sba_81
SiebelPath = C:\sba811v2
Replace the example values with the values for the monitored environment.
🔍 Configure the Siebel Config Collator
The Siebel Config Collator correlates the configuration data collected from the monitored Siebel environment.
In the configuration interface, locate:
MonitoringConfig > Siebel Config Collator
Configure:
|
Field |
Value |
|---|---|
|
Monitoring node |
Applicable monitoring node |
|
Engine |
Engine assigned to the Siebel environment |
|
Component type |
|
|
Name |
|
Review and submit the configuration.
🌐 Configure HTTP and SISNAPI monitoring
Configure the Siebel HTTP Monitor to validate the web tier and, where applicable, the SISNAPI path to a selected Siebel component.
Locate:
MonitoringConfig > Siebel HTTP Monitor
Configure:
|
Field |
Recommended value |
|---|---|
|
HTTP component type |
|
|
Name |
|
|
Server |
Previously configured Siebel server |
|
Application |
Siebel application to monitor |
|
Scheme |
|
|
Port |
Environment-specific port, such as |
|
Repeat interval |
|
Add these references to the monitor:
|
Reference |
Value |
|---|---|
|
|
Reference to the stored Siebel monitoring credential |
|
|
Component to validate through SISNAPI |
Use HTTPS wherever supported. Do not use the historical HTTP and port 80 defaults when the Siebel environment requires TLS.
🚫 Include or exclude Siebel components
Exclude components that are intentionally disabled, unused, or not operationally relevant. This prevents unnecessary collection and false availability alerts.
-
Open the Siebel component monitor.
Siebel Availability Monitor - Germain UX -
Locate References.
-
Add a reference named:
ExcludedComponents
-
Enter the component aliases as a comma-separated list.
For example:
EAIObjMgr_enu,CommInboundRcvr,WorkMon
Use exact component aliases. Do not insert spaces unless they are part of the actual alias.
Follow the same configuration pattern when the selected monitor supports an inclusion reference.
Review exclusions regularly. A component that becomes operationally important should not remain excluded.
🏆 Configure KPIs and SLAs
After collection begins:
-
Verify that each expected Siebel KPI receives data.
-
Establish a baseline during representative business activity.
-
Configure warning and critical thresholds.
-
Create alerts for availability, state, error, task, process, and capacity conditions.
-
Configure maintenance periods for planned Siebel outages.
-
Route alerts to the team responsible for the affected component.
-
Add diagnostic or corrective actions where appropriate.
Particular attention should be given to:
-
Component availability
-
Object Manager response time
-
Running tasks
-
Task utilization percentage
-
Tasks per process
-
Active MTS processes
-
MTS process utilization
-
Server Manager errors
-
Crash and core files
-
Log errors
-
HTTP availability
-
SISNAPI availability
See KPIs for Oracle Siebel CRM.
📊 Dashboards
GermainUX includes preconfigured dashboards for Siebel CRM.
Search the dashboard catalog for names beginning with Siebel, including:
-
Siebel Performance
-
Siebel Availability
Use dashboard filters to select the intended:
-
Application
-
Environment
-
Enterprise
-
Server
-
Component
-
Time range
✅ Validate the configuration
🧰 Server Manager and task data
Confirm that:
-
Siebel servers and components appear.
-
Component states are current.
-
Running and maximum task values are populated.
-
Task percentages are calculated correctly.
-
MTS process metrics appear.
-
Excluded components are omitted.
-
Collection repeats at the configured interval.
📄 Log and parser data
Confirm that:
-
The Engine can read the log paths.
-
New files and entries are detected.
-
Object Manager logs use the correct parser.
-
Server Manager output uses the Enterprise Manager parser.
-
Localized log content is parsed correctly.
-
Errors and exceptions populate the expected KPIs.
🗑️ Crash and Gateway data
Confirm that:
-
Crash or core files are detected.
-
The correct crash parser is selected.
-
siebns.datis monitored from the active Gateway. -
Configuration changes produce the expected events.
🖱️ HTTP and SISNAPI
Confirm that:
-
The web endpoint is reachable.
-
TLS validation succeeds.
-
Authentication succeeds when required.
-
The configured Siebel component responds.
-
Response times and availability populate the expected KPIs.
Troubleshooting
If no Siebel application data appears:
-
Confirm that the Engine is online.
-
Verify that the monitors are assigned to the correct Engine.
-
Test WMI, SSH, HTTP, and file access from the Engine host.
-
Confirm that the stored credential is valid.
-
Verify the Siebel Enterprise, Gateway, server, and installation path.
-
Confirm that all required component references are present.
-
Verify that the parser and directory-monitor component types were imported.
-
Check the Engine logs for authentication, permission, path, or parsing errors.
-
Confirm that the intended components are not listed under
ExcludedComponents. -
Verify that the monitoring intervals have elapsed.
-
Confirm that the relevant KPIs are enabled.
📚 Related documentation
ℹ️ Get More Information
GermainUX can help determine which monitoring, analytics and automation capabilities are appropriate for your Oracle Siebel CRM environment.
Component: Engine
Feature Availability: 2014.1 or later