The Sh Cache resource adaptor is integrated with the Metaswitch Service Assurance Server (SAS). SAS provides a mechanism to record and search detailed end-to-end tracing of call handling.

See the SAS Facility section in the Rhino extended API documentation for more information about SAS tracing.

Note

SAS tracing is supported on Rhino versions 2.6 and later.

The Sh Cache resource adaptor can be used with earlier Rhino versions if the Rhino API Compatibility SLEE library is deployed.

The Sh Cache resource adaptors automatically perform SAS tracing, if it is enabled in Rhino.

SAS markers

When using a SAS trail, the resource adaptors will raise a SAS marker for trail correlation. They raise a GENERIC_CORRELATOR_MARKER containing the Session-Id AVP.

SAS events

Sh Cache SAS events mini-bundle
---
version: 0.1
events:

  CACHE_HIT:
      summary: 'Found entry in cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      level: 20

  CACHE_MISS:
      summary: 'No entry found in cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      level: 20

  RETRIEVAL_ERROR:
      summary: 'Error retrieving value from cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      details: |
        Sh Cache RA experienced an error attempting to retrieve value from cache {{ var_data[0] }} for access key {{ var_data[1] }}

        {{ var_data[2] }}
      level: 40

  ASYNC_CACHE_HIT:
      summary: 'Async get found entry in cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      level: 20

  ASYNC_CACHE_MISS_FETCHING_VALUE:
      summary: 'Async get found no entry in cache {{ var_data[0] }} for access key {{ var_data[1] }}, fetching value'
      level: 20

  ASYNC_CACHE_MISS_VALUE_AVAILABLE:
  # This log has 2 now retired var_data parameters.
      summary: 'Async get value is immediately available'
      level: 20

  ASYNC_RETRIEVAL_ERROR:
      summary: 'Error asynchronously retrieving value from cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      details: |
        Sh Cache RA experienced an error attempting to asynchronously retrieve value from cache {{ var_data[0] }} for access key {{ var_data[1] }}

        {{ var_data[2] }}
      level: 40

  UPDATE_ERROR:
      summary: 'Error updating value in cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      details: |
        Sh Cache RA experienced an error attempting to update value in cache {{ var_data[0] }} for access key {{ var_data[1] }}

        {{ var_data[2] }}
      level: 40

  ASYNC_UPDATE_ERROR:
      summary: 'Error asynchronously updating value in cache {{ var_data[0] }} for access key {{ var_data[1] }}'
      details: |
        Sh Cache RA experienced an error attempting to asynchronously update value in cache {{ var_data[0] }} for access key {{ var_data[1] }}

        {{ var_data[2] }}
      level: 40
Previous page Next page