Skip to content

Logs

Logs, together with Actions, are intended to report all operations performed on the Cloud Server Shared CPU services.
However, unlike actions, which focus on the success or failure of the requested operation, logs focus on the executor of the action and its origin.

Retrieving Logs

To retrieve logs or make requests among them, a request is available to the following endpoint:

HTTP Request

GET /ecs/v2/logs

HTTP Response

{
  "total_logs": 477,
  "logs": [
    {
      "id": 480,
      "actor": "foo",
      "action": "Login",
      "severity": "info",
      "status": "success",
      "target_type": "User",
      "target": "foo",
      "created_at": "2025-01-17T08:35:42.521Z",
      "ip_address": "127.0.0.1",
      "user_agent": null,
      "url": "https://api.seeweb.it/ecs/v2/login",
      "location": null,
      "result_type": null,
      "result": null,
      "description": null,
      "extra_data": null
    },
    {
      "id": 479,
      "actor": "foo",
      "action": "Login",
      "severity": "info",
      "status": "success",
      "target_type": "User",
      "target": "foo",
      "created_at": "2025-01-17T08:31:45.196Z",
      "ip_address": "127.0.0.1",
      "user_agent": null,
      "url": "https://api.seeweb.it/ecs/v2/login",
      "location": null,
      "result_type": null,
      "result": null,
      "description": null,
      "extra_data": null
    }
  ]
}

Just like Actions, this endpoint also has the attributes:

  • start
  • length
  • resource

For more information, refer to Searching Actions.

Retrieving a Specific Log

It is possible to retrieve a specific log by using its id:

HTTP Request

GET /ecs/v2/logs/{logid}

HTTP Response

{
  "id": 480,
  "actor": "foo",
  "action": "Login",
  "severity": "info",
  "status": "success",
  "target_type": "User",
  "target": "foo",
  "created_at": "2025-01-17T08:35:42.521Z",
  "ip_address": "127.0.0.1",
  "user_agent": null,
  "url": "https://api.seeweb.it/ecs/v2/login",
  "location": null,
  "result_type": null,
  "result": null,
  "description": null,
  "extra_data": null
}