Skip to content

iectl iem device log-streaming configure

This command allows you to remotely configure the log and metric streaming settings for a device directly through the IEM. You provide a JSON configuration file that defines all the necessary parameters for log streaming, such as log levels, specific components to monitor, filtering rules, and output destinations. Once applied, these configuration changes are automatically synchronized between your IEM and the target Edge Device(s). This synchronization process typically completes within 30 seconds, ensuring your devices quickly adopt the new settings.

This command overwrites the existing log streaming configuration on the device with the content of the provided JSON file. To prevent data loss or unintended changes, it is highly recommended to backup (export) the current configuration from the device before importing a new one.

Synopsis

This command configures log streaming settings for a specific device through Industrial Edge Management. It accepts a JSON configuration file that defines log levels, filtering rules, output destinations, and other streaming parameters.

iectl iem device log-streaming configure [flags]

Options

      --device-id           id of the device that needs to be configured, use 'iectl iem device list' command to list available devices on Edge Management
      --file                path of the streaming log configuration file exported file from device ui or using 'iectl ied log-streaming export' command.
                            The file should be in JSON format and contains all existing configurations and settings as displayed in the web UI.
                            You can modify the file to change the settings. Please ensure that the file adheres to the correct JSON format and structure as shown in the exported file. Use this modified file to apply new settings to your device
  -h, --help                help for configure

NOTICE

To avoid data loss, please backup (export) the configurations before importing.
For more information on log streaming, see Logging Overview.

Options inherited from parent commands

  -o, --output string   output format
  -q, --query string    query on result of object
  -v, --verbose         verbose output

Example

iectl iem device log-streaming configure --device-id "sampleDeviceId" --file "/path/to/file" 
iectl iem device log-streaming configure --device-id "sampleDeviceId_1" --device-id "sampleDeviceId_2" --file "/path/to/file" 

SEE ALSO

  • iectl iem device log-streaming - cmodify and view streaming logs settings on device via Industrial Edge Management using subcommands like 'iectl iem device log-streaming configure' Use --file argument to provide valid configuration file in json format, this will overwrite previous configurations. To avoid data loss, please backup (export) the configurations before importing
  • iectl iem device log-streaming sync-status - view current sync status for specific device on Industrial Edge Management. While configuring streaming logs on device via Industrial Edge Management the changes will be automatically synchronized between your Industrial Edge Management and the Edge Device
  • iectl iem device log-streaming view - view current streaming logs configurations of a specific device on Industrial Edge Management