Skip to main content

XOS agent configuration

You can additionally monitor resources on the database server by setting the following options in the xos.conf file. To use this option, set the xos option to true in the whatap.conf file.

  • interconnect_nic String RAC

    It collects network card information corresponding to the set option value. If this option is not set, interconnect-related metrics are not collected.

    xos.conf
    # example
    interconnect_nic=enp0s3

    Enter the network interface used for interconnect of Real Application Cluster (RAC) among the network interfaces confirmed by the netstat -i command. The set values are used to monitor the performance and activities of the network card.

  • cpu_limit Int

    Default 0

    It collects the process data with a value greater than the set limit. If it is 1.23% (1/100% step), set it to 123.

  • mem_limit Int

    Default 10240

    It collects the process data with a value greater than the set limit. 10240 (Kbytes) indicates 10 MB.

  • disk_usage_interval Second

    Default 60

    Displays the disk utilizations, free sizes, and total sizes for each instance. If the value is 0, disk usage is not collected.

  • process String

    The execution status of processes can be monitored. Enter the process name as an option value. Multiple items can be registered using comma (,) as the delimiter.

    xos.conf
    process={process_name}

    For example, to set the top and lock.sh processes to be monitored, set the options as follows:

    xos.conf
    process=top,lock.sh
    Note

    You can use the process option to send an alert when a process running on the database is ended. For more information, see the following.

  • iplist_interval Second

    You can collect a list of IPs for your database servers. Set the time interval in seconds (at least 3 seconds) for collection.

  • file String

    To use the Log menus (Live Tail, Log Trend, Log Search, Log Configuration), enter the absolute path in the file option for the log files to be monitored.

    xos.conf
    file=/opt/oracle/log
    Tip

    To add a logfile to monitor, add options in the same way as file, file1, file2.

    xos.conf
    file={log_file_path1}
    file1={log_file_path2}
    file2={log_file_path3}
    file3={log_file_path4}

User Metric Collection (SHMON)

SHMON periodically collects the results of user-defined shell scripts and stores them as metrics.

  • shmon Int

    Default value: 1

    Supported version: dbx 2.55.01 or later & xos 1.2.0f or later

Configuration

  1. Create a shmon directory in the agent installation path.
  2. Save the script to be collected as a .sh file.
  3. Enable SHMON in xos.conf.
  4. Restart the agent.
  5. In the Icon Sitemap > Metrics Search menu, check the shmon category.
# xos.conf
shmon=1