You can use the streamtool command-line interface or
the IBM®
Streams graphical user interfaces to modify settings for IBM
Streams log and trace properties.
Before you begin
IBM
Streams uses access control lists (ACLs) to manage security for domains and instances. To change or
delete domain property settings, you must have read and write authority for the config domain
object. To change or delete instance property settings, you must have read and write authority for
the config instance object. For more information about ACLs and access permissions,
see User authorization.
Making changes to log and trace settings can affect the performance of IBM
Streams. It is recommended that you change these settings based on guidance from IBM Support.
For a list of log and trace properties, use the following commands:
- streamtool man domainproperties for information about domain properties
- streamtool man properties for information about instance properties
Procedure
To modify log and trace properties, use the
streamtool command-line interface, the Domain Manager, or the Streams
Console. Some log and trace properties can also be updated by using Streams Studio.
- To update the property values for domains and instances, you can use the
streamtool commands that are listed in the following table.
Table 1. Commands for modifying log and trace properties for IBM
Streams instances| Command |
Description |
|---|
streamtool setdomainproperty
streamtool setproperty
|
Use these commands to assign a value to one or more domain or instance
properties. IBM
Streams displays the previous property value and a confirmation message that the new value is
assigned. |
streamtool rmdomainproperty
streamtool rmproperty
|
Use these commands to remove one or more domain or instance properties. After
a property is removed, the default value applies for that property. |
| streamtool submitjob |
Specify the -C or --config option on
this command to change the trace settings for application jobs that are being started. |
| streamtool updatepe |
Specify the -C or --config option on
this command to change the trace settings for running processing elements or application
jobs. |
- To update the property values for domains, you can use the Domain Manager.
- To update property values for instances, you can use the Streams
Console.
- For information about the property values that you can update in Streams Studio, see Managing log
and trace data.