Infrastructure Integration

Configuration

  1. To make sure that IIS performance counters will be sent to WMI, resync the WMI counters.

Run the following in cmd.exe:

    winmgmt /resyncperf
  1. Configure the agent by editing /etc/netsil-dd-agent/conf.d/iis.yamlin the collectors.

Example:

    init_config:
    instances:
      # By default, this check will run against a single instance - the current
      # machine that the Agent is running on. It will check the WMI performance
      # counters for IIS on that machine.
      #
      # If you want to check other remote machines as well, you can add one
      # instance per host. Note: If you also want to check the counters on the
      # current machine, you will have to create an instance with empty params.
      #
      # The optional `provider` parameter allows to specify a WMI provider
      # (default to `32` on dd-agent 32-bit or `64`).It is used to request
      # WMI data from the non-default provider. Available options are: `32` or `64`.
      # For more information: https://msdn.microsoft.com/en-us/library/aa393067(v=vs.85).aspx
      #
      # The `sites` parameter allows you to specify a list of sites you want to
      # read metrics from. With sites specified, metrics will be tagged with the
      # site name. If you don't define any sites, the check will pull the
      # aggregate values across all sites.
      #
      # Here's an example of configuration that would check the current machine
      # and a remote machine called MYREMOTESERVER. For the remote host we are
      # only pulling metrics from the default site.
      #

      # "." means the current host
      - host: .
      #   tags:
      #     - myapp1
      #   sites:
      #     - Default Web Site
      #
      # - host: MYREMOTESERVER
      #   username: MYREMOTESERVER\fred
      #   password: mysecretpassword
      #   is_2008: false  # NOTE: because of a typo in IIS6/7 (typically on W2K8)
                  # where perfmon reports TotalBytesTransferred as
                  # TotalBytesTransfered, you may have to enable this
                  # to grab the IIS metrics in that environment.
      #   tags:
      #     - myapp2
      #     - east
      #   sites:
      #     - Default Web Site
  1. Check and make sure that all yaml files are valid with following command:

    /etc/init.d/netsil-collectors configcheck
    
  2. Restart the Agent using the following command:

    /etc/init.d/netsil-collectors restart
    
  3. Execute the info command to verify that the integration check has passed:

    /etc/init.d/netsil-collectors info
    

The output of the command should contain a section similar to the following:

        Checks
        ======

          [...]

          iis
          ---
              - instance #0 [OK]
              - Collected 8 metrics & 0 events

Infrastructure Datasources

Datasource Available Aggregations Unit Description
iis.uptime avg max min sum second The amount of time the IIS server has been running
iis.net.bytes_sent avg max min sum byte/second The number of bytes served per second
iis.net.bytes_rcvd avg max min sum byte/second The number of bytes received per second
iis.net.bytes_total avg max min sum byte/second The total number of bytes transferred per second
iis.net.num_connections avg max min sum connection The number of active connections
iis.net.files_sent avg max min sum file/second The number of files sent per second
iis.net.files_rcvd avg max min sum file/second The number of files received per second
iis.net.connection_attempts avg max min sum connection/second The number of connection attempts per second
iis.httpd_request_method.get avg max min sum request/second The number of GET requests per second
iis.httpd_request_method.post avg max min sum request/second The number of POST requests per second
iis.httpd_request_method.head avg max min sum request/second The number of HEAD requests per second
iis.httpd_request_method.put avg max min sum request/second The number of PUT requests per second
iis.httpd_request_method.delete avg max min sum request/second The number of DELETE requests per second
iis.httpd_request_method.options avg max min sum request/second The number of OPTIONS requests per second
iis.httpd_request_method.trace avg max min sum request/second The number of TRACE requests per second
iis.errors.not_found avg max min sum error/second The number of not found errors per second (typically reported as an HTTP 404 response code)
iis.errors.locked avg max min sum error/second The number of locked errors per second (typically reported as an HTTP 423 response code)
iis.users.anon avg max min sum request/second The number of requests from users over an anonymous connection per second
iis.users.nonanon avg max min sum request/second The number of requests from users over a non-anonymous connection per second
iis.requests.cgi avg max min sum request/second The number of Common Gateway Interface requests executed per second
iis.requests.isapi avg max min sum request/second The number of ISAPI requests executed per second