Client commandline arguments

Arguments

Apply to <DT_HOME>\dtclient:

-kiosk [interval]

Optional value: Positive integer value for the interval (seconds, default 30, minimum 1).

Starts the client in kiosk mode. It automatically hides the mouse cursor, expands to full screen, and cycles through all open dashboards at the default or specified interval. For example -kiosk 10.

Use the Webstart Client in the kiosk mode by applying the arguments in the Web-start URL: http://<dynaTraceServerName>:8021/webstart/Client/client.jnlp?argument=-kiosk&argument=10

See Webstart Client for other functionality.

Kiosk mode control: Open or close dashboards and they are included in or excluded from the process.
Press ESC to pauses or resume automatic switching. Use Page Up and Page Down to go to the previous or next dashboard. Press F11 to toggle the full screen mode.

If a dashboard tab disappears, drag it from the right.

-dashboard [dashboardlocation]

[dashboardlocation]: Optionally includes overriding source, compare source, and filter settings.

Opens the specified dashboard when the client starts. If you specify a source, compare source, or filters, an unsaved copy of the dashboard is created so that the original does not change.

Argument format:
dashboardlocation = location [ ? query ] location = online://<servername>/<dashboard-name> | local://<file-system-path> | internal://<dashboard-name>

While online and local are self-explanatory, internal refers to dashboards that are not listed explicitly, but are available in the Start Center or are integrated with other products.
query = querypart [ & querypart ... ]
querypart = [source=sourcestring] | [compare=sourcestring] | [filter=filterstring [&filter=filterstring ...]]

See XML Reporting (REST) and REST Filters for information on sourcestring and filterstring.

Note

<servername> is case-sensitive. Type it as it appears in the client (not in upper case like in the Windows System control panel). Use the System Profile names, not the internal ID. For local:// do not supply the .dashboard.xml extension, AppMon supplies it automatically.

Examples: <DT_HOME>/dtclient -dashboard "online://<dynaTraceServerName>/Incident Dashboard?filter=tf:Last7d" <DT_HOME>/dtclient -dashboard "online://<dynaTraceServerName>/Incident Dashboard?filter=tf:Last7d" <DT_HOME>/dtclient -dashboard "local://C:/tmp/System Information"

There may be path length limits for dashboards that are stored in the Users directory. The following code block does not work: <DT_HOME>/dtclient -dashboard "local://C:/Users/test-user/.dynaTrace/dynaTrace <version>/client/conf/dashboards/System Information"

-installplugin [pluginfile]

pluginfile: A plugin installation file

Installs the plugin when the client starts.

-forceFullAnalysis

Prevents the client from executing a quick analysis.

-hidestartcenter

Prevents the client from opening the Start Center automatically.

See Webstart Client > Webstart Client URL Equivalent to Command Line Arguments for the same functionality in the Set up the Webstart Client.

Troubleshooting

If the dashboard does not open in the client, check the log file. To do this, follow these steps:

  1. Open the System Information dashlet:
    • AppMon 2017 May In the Cockpit, expand Status Overview node, and double-click System Information.
    • AppMon 2018 February In the sidebar, click System Information from the Server section.
  2. Expand DynatraceClient@host_name:nnnn and log files.
  3. Open the most recent log file.
  4. Scroll down and look for errors. For example, <dateTime> WARNING Client Invalid syntax for Dashboard argument: 'online://easyTravel Database?filter=tf:Last3d'.

For this example, the filter Last3d doesn´t exist. Its name is Last72h. For information on valid filter expressions, see REST Filters.