Modifying log and trace properties

You can use the streamtool command-line interface or the Teracloud® Streams graphical user interfaces to modify settings for Teracloud® Streams log and trace properties.

Before you begin

Teracloud® 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 Teracloud® Streams. It is recommended that you change these settings based on guidance from Teracloud® 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 or the Streams Console.
  • 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 Teracloud® Streams instances

    The table contains two columns. The first column contains the name of the streamtool command. The second column describes when to use the command.
    Command Description

    streamtool setdomainproperty
    streamtool setproperty

    		 Use these commands to assign a value to one or more domain or instance properties. Teracloud® 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 property values for instances, you can use the Streams Console.