// removed jquery ui css and js

View Log Elements

Details

API Details
NameView Log Elements
Description

View log levels and log tracking status for some (identified in the table below) CloudCenter servers and services. See Locate Log Files for additional context.

MethodGET
URI
  • v1/logs (CCM)
  • v1/logs?nodeType=CCO&regionId=regionId (CCO)
  • v1/logs?nodeType=CLOUDBLADE&regionId=regionId (cloudblade service)
  • v1/logs?nodeType=CONTAINERBLADE&regionId=regionId (containerblade service)
  • v1/logs?nodeType=WORKER&regionId=regionId &nodeId=nodeId (depends on the cloud – Application VM)
CloudCenter Release
  • Introduced in CloudCenter 4.4.
  • Enhanced in CloudCenter 4.9.0 to include log tracking for the CLOUDBLADE and CONTAINERBLADE services
Notes
  • For additional context on <PORT> usage in the following example(s), see Base URI Format.
  • The following table provides additional details on permissions to issue this API.

    ServerAPI Permissions
    CCMOnly root admin
    CCOAny tenant admin with the following permissions:
    • Has access to the cloud region
    • Has a user cloud account configured on the CCO
    CLOUDBLADE
    CONTAINERBLADE
    WORKER (Application VM)Any user who has MANAGE or AUTHORIZE access to the deployment environment used to start the job (that started the node).
ESB Header
  • action (CCM): get.logs
  • action (CCO): get.logs
    actionparam: nodeType=CCO
    &regionId=regionId
  • action (cloudblade): get.logs
    actionparam: nodeType=CLOUDBLADE
    &regionId=regionId
  • action (containerblade): get.logs
    actionparam: nodeType=CONTAINERBLADE
    &regionId=regionId
  • action (Application VM): get.logs
    actionparam: nodeType=WORKER &regionId=regionId &nodeId=
    nodeId (depends on the cloud)

Example 1: CCM Log Levels

curl -k -X GET -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/logs?nodeType=CCM" 

Response

{
    "nodeType": "CCM",
    "logPackages": [{
        "packageName": "com.osmosix",
        "level": "DEBUG",
        "enabled": true
    }, {
        "packageName": "com.cliqr",
        "level": "DEBUG",
        "enabled": true
    }, {
        "packageName": "com.osmosix.commons.communication",
        "level": "INFO",
        "enabled": true
    }, {
        "packageName": "org.springframework.core",
        "level": "INFO",
        "enabled": true
    }, {
        "packageName": "PROTOCOL_MESSAGE",
        "level": "INFO",
        "enabled": true
    }, {
        "packageName": "org.apache.http",
        "level": "TRACE",
        "enabled": false
    }]
}

Example 2: CONTAINERBLADE Log Levels

curl -k -X GET -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/logs?nodeType=CONTAINERBLADE&regionId=4" 

Response

{
   "nodeType":"CONTAINERBLADE",
   "logPackages":[
      {
         "packageName":"ROOT",
         "level":"INFO",
         "enabled":true
      },
      {
         "packageName":"com.cliqr",
         "level":"DEBUG",
         "enabled":true
      },
      {
         "packageName":"com.osmosix",
         "level":"DEBUG",
         "enabled":true
      }
   ]
}

Request Attributes

 nodeType
  • Description: A string that identifies the CloudCenter component.

  • Type: Enumeration

    EnumerationDescription
    CCMThe CCM component.
    CCOThe CCO component.
    CLOUDBLADE

    Effective CloudCenter 4.9.0, a component that provides a uniform cloud service consumption of various cloud providers offering VM deployments (public clouds and private clouds/datacenters).

    CONTAINERBLADE

    Effective CloudCenter 4.9.0, a component that provides a uniform cloud service consumption of various cloud providers offering container deployments (container clouds).

    WORKERThe Worker (Application VM) component.

regionId
  • DescriptionUnique, system-generated identifier for the cloud region 

  • Type: String

Retrieves the region identifier to map to the CCO, CLOUDBLADE/CONTAINERBLADE services, or the Application VM.

regionId
  • DescriptionUnique, system-generated identifier for the cloud region 

  • Type: String

cloudRegionId
  • Description: Unique, system-generated identifier for a cloud region
  • Type: String

nodeId
  • DescriptionUnique identifier for the node – generated by the cloud provider

  • Type: String

Identifies the ID for the application VM on which the log operations must be performed.

Response Attributes

logPackages
  • Description: Detail about each log file level and status.
  • Type: Sequence of log packages details

     packageName 
    • Description: The log file name for this package. 
    • Type: String
    level
    • Description: The log level for this file.
    • Type: Enumeration

      EnumerationDescription
      ALLAll levels of logging
      DEBUGDetailed information on the system flow and are generally written to logs.
      ERROROther runtime errors or unexpected conditions and are generally visible on the CCM UI.
      FATALSevere errors that cause premature termination and are generally visible on th CCM UI.
      INFOStartup or shut down runtime events and are are generally visible on the CCM UI.
      so be conservative and keep to a minimum.
      TRACEDetailed log information and are generally written to logs.
      WARNUse of deprecated APIs, poor use of API, other runtime situations that are undesirable or unexpected and area generally visible on the CCM UI
       TRACE_INT Detailed log information and are generally written to logs.
      OFFTurns off logging.
    enabled
    • Description: Indicates that this resource has been enabled. The default differs based on the resource.

      • true = The resource has been enabled (v2 aging and suspension policies are enabled by default).

      • false = The resource has not been enabled.

    • Type: Boolean

© 2017-2019 Cisco Systems, Inc. All rights reserved