Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

IBM DataPower Operations Dashboard contains an extensive set of parameters that let administrators fine-tune the system's behavior to the installation requirements.
The following sections describe these parameters in detail. 

...

ParameterCategoryDefault ValueDescription
Enable Queries Emails SMTPAlertstrueEnable / Disable publishing alerts via SMTP server
Enable Queries Emails SMTP WSAlertsfalseEnable / Disable publishing alerts via Web Service
Fields to Ignore in ElasticSearch Response in AlertsAlertsdoc_count_error_upper_bound,sum_other_doc_countField to omit from alert description
Enable Queries Output FileAlertsfalseEnable / Disable publishing alerts as file in local file system
Syslog Severity Field ValueAlertsinfoSyslog record message level.
Possible values: debug, info, notice, warning, err, crit, alert, emerg
Alerts Syslog Server HostnameAlerts172.77.77.7
Syslog server hostname or IP address.
Alerts Syslog Server PortAlerts60031
Syslog server listening port.

...

Parameter

Category

Default Value

Description

IDG Transactions Page ColumnsDashboardsTransaction ID, Service Name, Operation, Time, Device, Domain, Status, Transaction ID, Client IP, Global Transaction ID, Elapsed, PayloadControls which columns will appear in the Investigate->Transactions Page, you can omit or reorder the columns.
Any mistakes in the input will cause the display to revert to the default value.
The Payload field will not appear to users that does not have authorization to view payloads

Possible values (not case sensitive):
Transaction ID, Service Name, Operation, Time, Device, Domain, Status, Transaction ID, Client Client IP, Global Transaction ID, Elapsed, Payload
IDG Raw Message Page ColumnsDashboardsTransaction ID, Device, Domain, Category, Severity, Time, Direction, Object Type, Object Name, Transaction ID, Client IP, Message Code, Message

Controls which columns will appear in the Investigate→Raw Messages Page, you can omit or reorder the columns.
Any mistake in the input will cause the display to revert to the default value.

Possible values (not case sensitive):
Device, Domain, Category, Severity, Time, Direction, Object Type, Object Name, Transaction ID, Client IP, Message Code, Message, Global Transaction ID, B2B Message ID, B2B From Partner ID, B2B to Partner ID, B2B from partner profile, B2B to Partner Profile, 

APIC Transactions Page ColumnsDashboardsTransaction ID, Time, Device, Catalog Name, Space Name, Product, Plan Name, API Name, API Version, APP Name, Method, URI, Status, Transaction ID, HTTP Res. Code, Client IP, Elapsed, Payload

Controls which columns will appear in the APIC Investigate->Transactions Page, you can omit or reorder the columns.
Any mistakes in the input will cause the display to revert to the default value.
The Payload field will not appear to users that does not have authorization to view payloads

Possible values (not case sensitive):
API NameTransaction ID, Time, Device, Domain,  Catalog Name, Space Name, Product, Plan Name, API Name, Operation ID, Client ID, OAuth ScopeAPI Version, APP Name, Method, URI, Status, Transaction IDHTTP Res. Code, Client IP, Global Transaction ID, Elapsed, Plan Name, Domain, Payload, Method, Gateway Type

Service URI Dashboard Percentiles (3 comma separated decimals)

Dashboards

90.0, 95.0, 99.0

Controls the percentiles shown in the rightmost columns of the Service URI Calls page and the API URI calls page, enter decimal values between 0-99.9

Service URL Dashboard Percentiles (3 comma separated decimals)

Dashboards

90.0, 95.0, 99.0

Controls the percentiles shown in the rightmost columns of the Service URL Calls page and the API URL calls page, enter decimal values between 0-99.9

APIC Recent Activity Page Latency PercentileDashboards90.0Controls the percentile shown in the APIC Recent Activity page, enter a decimal value between 0-99.9

...

Parameter

Category

Default Value

Description

From Address

Email

from@example.com

The from address used for the report email.

SMTP Host

Email SMTP

smtp.example.com

Destination SMTP host

SMTP Password

Email SMTP

********

Password for logging in to the SMTP host. If no authentication required leave this field empty.

SMTP Port

Email SMTP

465

Destination SMTP host port

SMTP User

Email SMTP

mailer@example.com

Username for logging in to the SMTP host. If no authentication required leave this field empty.

SMTP SSL EnabledEmail SMTPtrueEnable / Disable TLS/SSL


SMTP WS Endpoint URI

Email SMTP WS

/SMTPSender

Destination URI for sending reports via Web-Service

SMTP WS Host

Email SMTP WS

localhost

Destination hostname for sending reports via Web-Service

SMTP WS Port

Email SMTP WS

8080

Destination port for sending reports via Web-Service

SMTP WS Protocol

Email SMTP WS

HTTP

Protocol for accessing the Web-Service host

Valid values: HTTP / HTTPS

SMTP WS User

Email SMTP WS

user

User used for sending reports via Web-Service. This value is sent using HTTP Basic Authentication.

SMTP WS Password

Email SMTP WS

********

Password used for sending reports via Web-Service. This value is sent using HTTP Basic Authentication.

...

ParameterCategoryDefaultDescription
Internal Alerts - Check Agents Interval in SecondsHealth300How often to check whether DPOD's syslog and WS-M agents are up and working
Internal Alerts - Check Derby Interval in SecondsHealth300How often to check whether DPOD's internal database is up and working
Internal Alerts - Check Dropped Syslogs Interval in SecondsHealth600How often to check whether DPOD's syslog agents lost incoming messages
Internal Alerts - Check Dropped WS-M Messages Interval in SecondsHealth600How often to check whether DPOD's WS-M agents lost incoming payloads
Internal Alerts - Check ES Interval in SecondsHealth300How often to check whether DPOD's big data component is up and working
Internal Alerts - Check File System Interval in SecondsHealth300How often to check whether DPOD's filesystem is out of space
Internal Alerts - Check Retention Interval in SecondsHealth300How often to check whether DPOD's internal big data retention process is working
Internal Alerts - Check Log Targets Misconfig Interval in SecondsHealth43200How often to check whether the monitored gateways for misconfigured DPOD log targets
Internal Alerts - Send Email on AlertHealthfalseWhether or not to send an Email when a problem was detected by the internal health monitoring
Internal Alerts - Email Destination Address for AlertsHealthNo DefaultDestination Email address for sending internal health alerts
Internal Alerts - Send Syslog on AlertHealthfalseWhether or not to send a Syslog message when a problem was detected by the internal health monitoring
Interval in Seconds to Sample Logging TargetsHealth300How often to sample DPOD's log targets in the monitored devices
Interval in Seconds to Sample Nodes Health StatisticsHealth300How often to collect statistics on DPOD's big data nodes
Interval in Seconds to Monitor Objects StatusHealth300How often to monitor enabled but down objects in the monitored devices
Object Status Monitor Class List (All, Default or a Custom List)HealthDefault

By default, the Failed Objects dashboard (under the "explore" menu) displays only common object classes,
set this option to All to make it sample all object classes in the monitored gateways, or enter a custom list of comma separated classes

Interval in Seconds to Sample WSM Agents StatisticsHealth300How often to sample WS-M Agents in the monitored devices
Internal Alerts REST API Service HostHealthlocalhostHost name / IP address of the maintenance housekeeping server to save and publish internal alerts.
Internal Alerts REST API Service PortHealth8084Port of the maintenance housekeeping service to save and publish internal alerts.

...

ParameterCategoryDefaultDescription
Allow Monitoring Transactions in Default DomainTransactionsfalseWhether or not the "Support TX in the Default Domain" box will be displayed in the Monitored Devices→Setup page
Show Custom Transaction View SelectionTransactionsfalseWhether or not the "Custom TX View" checkbox will be displayed in the Product Views  
Default Transactions Source (syslog/logical)TransactionssyslogIf the "Custom TX View" is displayed, what will be the default for users on their first sign in.
Logical Transaction, Custom String 1 Table HeaderTransactionsCustom String 1The Table Header and Filter names for "Custom String 1" in the transactions page
Logical Transaction, Custom String 2 Table HeaderTransactionsCustom String 2The Table Header and Filter names for "Custom String 2" in the transactions page
Transaction Analysis Level - User Override PathTransactions(blank)Where to take the user override file for the syslog analysis message groups, no value (blank) means there is no override file
Transaction Analysis Level - Max TPSTransactionsCore, MemoryReqRes, B2B, error

The message group names and log level for the Max TPS analysis level,
The last parameter must be a valid log level name (debug, info, notice, warn. error, critic).
The values must be comma separated, lower, upper or mixed case are allowed.

Transaction Analysis Level - More TPSTransactionsCore, MemoryReqRes, B2B, noticeThe message group names and log level for the More TPS analysis level,
The last parameter must be a valid log level name (debug, info, notice, warn. error, critic).
The values must be comma separated, lower, upper or mixed case are allowed.
Transaction Analysis Level - BalancedTransactionsCore, MemoryReqRes, B2B, MemActionLevel, noticeThe message group names and log level for the Balanced analysis level,
The last parameter must be a valid log level name (debug, info, notice, warn. error, critic).
The values must be comma separated, lower, upper or mixed case are allowed.
Transaction Analysis Level - More DataTransactionsCore, MemoryReqRes, B2B, MemActionLevel, ReqPayloadSize, ExtLatency, infoThe message group names and log level for the More Data analysis level,
The last parameter must be a valid log level name (debug, info, notice, warn. error, critic).
The values must be comma separated, lower, upper or mixed case are allowed.
Transaction Analysis Level - Max DataTransactionsCore, MemoryReqRes, B2B, MemActionLevel, ReqPayloadSize, ExtLatency, Sidecalls, infoThe message group names and log level for the Max Data analysis level,
The last parameter must be a valid log level name (debug, info, notice, warn. error, critic).
The values must be comma separated, lower, upper or mixed case are allowed.
Deprecated Extended Transaction EnabledTransactionsfalseIf true system will show by defaut default the Deprecated Extended Transaction page.

Miscellaneous Parameters

...

Size of next/previous transaction results

TransactionsdefaultThe size of next/previous transaction results.
The default is the size of the transactions list page from where the user clicked on the transaction ID link.

Miscellaneous Parameters

The following parameters control various other functions.

Parameter

Category

Default Value

Description

Enable agents management

Agents

true

Set to true, unless using an External Self Service Console installation, in which case it should be false.

Certificate monitoring duration in days

Certificate Monitoring

60

DataPower Gateways are able to send an alert a configurable number of days before certificates are about to expire. DPOD leverages this ability in the certificate monitoring screens.

When a new monitored device is added to DPOD, the value in this parameter is copied to the corresponding parameter on the device.

This value does not affect already-monitored devices. If you wish to change this in previously added devices, you need to do so manually.

Time to Keep WS-M Payloads (1d, 1w, blank)WSM(blank)Automatically delete WS-M payloads from store, possible values are 1d = one day, 1w = one week, no value = don't delete automatically
Interval in Seconds to Sample Gateway MQ Objects StatsWDP Objects300How often to sample the gateway's MQ objects, the data is shown in the Gateway MQ Overview dashboard
Interval in Seconds to Analyze Audit LogsRestarts300How often to sample the gateway's audit logs, this data will be used for the restarts dashboard

...

ParameterCategoryDefault ValueDescription
Is Internal Self Service InstallationSystemtrueIs the current DPOD installation an Internal Self Service Console - change this value only for external self service console scenarion
Internal Self Service AddressSystemhttps://montier-managementThe address of the internal Self Service Console - change this value only for external self service console scenarion
Internal Self Service User NameSystem(no default)

The DPOD user name that will be used to access the internal Self Service Console - change this value only for external self service console scenarion

Info

We recommend that you create a new user for this purpose


Internal Self Service PasswordSystem(no default)The DPOD user's passwordthat will be used to access the internal Self Service Console - change this value only for external self service console scenarion
Internal Self Service Webserver PortSystem443The internal Self Service Console's webserver port - change this value only for external self service console scenarion
Interval in Seconds to Check and Cleanup DB TablesSystem28800Interval in seconds to cleanup DB tables that exceeded the threshold size (threshold for each table is defined in a different system parameter)
Threshold in MB to Clean Reports Execution TableSystem100Threshold in MB to cleanup the reports execution DB table
Threshold in days to Clean Reports Execution TableSystem30Threshold in days to cleanup the reports execution DB table
Threshold in MB to Clean Alerts Execution TableSystem200Threshold in MB to cleanup the alerts execution DB table
Threshold in days to Clean Alerts Execution TableSystem30Threshold in days to cleanup the alerts execution DB table
Threshold in MB to Clean Services Portal Execution TableSystem100Threshold in MB to cleanup the services portal execution DB table
Threshold in MB to Clean Maintenance Plan ExecutionSystem100Threshold in MB to cleanup the maintenance execution DB tables (backup, sync and firmware upgrade)
The HTTP Address of the UISystem(no default)The URL used to access DPOD Web Console root context, e.g. https://dpod.example.com (without /op or /admin suffixes). This URL will be used to create URLs to DPOD Web Console that are embedded in emails sent by maintenance plans or sharing by email from the Web Console.
The HTTP Address of the UI - External (optional)System(no default)The URL used to access DPOD Web Console root context from external networks, e.g. https://dpod.example.com (without /op or /admin suffixes). If this URL if specified, an additional link will be added to email addresses where "The HTTP Address of the UI" is used, to allow external users to have an additional link they can use instead of the internal link.
Experimental FeaturesExperimental(no default)For support use only, do not change unless advised by L2/L3 support 

...