The Shibboleth IdP UI application will send data on a daily basis to the TIER instrumentation server. This data is anonymous, and is only used to report on usage of the product with some basic metrics. Some values will be for overall usage of the system, while others will be cumulative counts since the last time the beacon was sent. An example of the forwarded data is as follows:


{
  "msgType": "TIERBEACON",
  "msgName": "TIER",
  "msgVersion": "1.0",
  "tbProduct": "ShibUi",
  "tbProductVersion": "1.18.0",
  "tbTIERRelease": "PACKAGE_1.18.0",
  "tbMaintainer": "Unicon",
  "shibui": {
    "authMechanisms": [
      "default"
    ],
    "db": "H2",
    "numberOfMetadataSources": 2,
    "numberOfMetadataProviders": 0,
    "numberOfFilters": 1,
    "dailyLogins": 1,
    "dailyUniqueUserLogins": 1,
    "numberOfGroups": 11,
    "numberOfRoles": 6
  },
  "beaconEvents": {
    "METADATA_SOURCE_CREATED": 2,
    "METADATA_PROVIDER_MODIFIED": 1,
    "METADATA_PROVIDER_CREATED": 1,
    "METADATA_SOURCE_ENABLED": 1
  }
}


The scheduled time for sending the data is randomly generated when the database is initialized. The time is a random minute between 12:00AM and 04:00AM (GMT). If multiple hosts are using the same application database, only one node will send the daily data set.


Configuration values have defaults that can be used to fine-tune the beacon process:

  • shibui.beacon.enabled=true (can be set to false to disable the beacon entirely)
  • shibui.beacon.url=http://collector.testbed.tier.internet2.edu:5001 (URL or list of URLs to send data to)
  • shibui.beacon.send.cron=ss mm hh * * ? (can be used to hard-code a specific time instead of a randomly generated schedule)


  • No labels