Paste, share & analyse your logs
Built for Minecraft & Hytale
Integrate getName()); ?> directly into your server panel, your hosting software or anything else. This platform was built for high performance automation and can easily be integrated into any existing software via our HTTP API.
| Field | Required | Type | Description |
|---|---|---|---|
| content | string | The raw log file content as string. Limited to get(ConfigKey::STORAGE_LIMIT_BYTES) / 1024 / 1024, 2); ?> MiB and get(ConfigKey::STORAGE_LIMIT_LINES)); ?> lines. Will be truncated if possible and necessary, but truncating on the client side is recommended. | |
| source | string | The name of the source, e.g. a domain or software name. | |
| metadata | array | An array of metadata entries. |
{
"content": "[log file content...]",
"source": "example.org"
}
You can send metadata alongside the log content to be displayed on the log page and/or be read by other applications through this API. This is entirely optional, but can help to provide additional context, e.g. internal server IDs, software versions etc.
A metadata entry is an object with the following fields:
| Field | Required | Type | Description |
|---|---|---|---|
| key | string | The metadata key. Can be used to identify the entry in your code later. | |
| value | string|int|float|bool|null | The metadata value. | |
| label | string | The display label. If not provided, the key will be used as label. | |
| visible | bool | Whether this metadata should be visible on the log page or is only available through the API. Default is true. |
{
"content": "[log file content...]",
"source": "example.org",
"metadata": [
{
"key": "server_id",
"value": 12345,
"visible": false
},
{
"key": "software_version",
"value": "1.2.3",
"label": "Software Version",
"visible": true
}
]
}
{
"success":true,
"id":"WnMMikq",
"source":null,
"created":1769597979,
"expires":1777373979,
"size":157369,
"lines":1201,
"errors":8,
"url": "withPath("/WnMMikq")->toString()); ?>",
"raw": "withPath("/1/raw/WnMMikq")->toString()); ?>",
"token":"78351fafe495398163fff847f9a26dda440435dcf7b5f92e8e36308f3683d771",
"metadata": [
{
"key": "server_id",
"value": 12345,
"visible": false
},
{
"key": "software_version",
"value": "1.2.3",
"label": "Software Version",
"visible": true
}
]
}
{
"success": false,
"error": "Required field 'content' not found."
}
This endpoint only returns the log info and metadata by default (same response as creating a log), you can also get the content in the same request by enabling it in different formats using GET parameters. You can combine multiple parameters to get multiple content formats in one request, but keep in mind that this will increase the response size.
| GET Parameter | Response field | Description |
|---|---|---|
| raw | content.raw | Includes the raw log content as string in the response. |
| parsed | content.parsed | Includes the parsed log content as array/objects in the response. |
| insights | content.insights | Includes the automatically detected insights in the response. |
{
"success":true,
"id":"WnMMikq",
"source":null,
"created":1769597979,
"expires":1777373979,
"size":157369,
"lines":1201,
"errors":8,
"url": "withPath("/WnMMikq")->toString()); ?>",
"raw": "withPath("/1/raw/WnMMikq")->toString()); ?>",
"metadata": [
{
"key": "server_id",
"value": 12345,
"visible": false
},
{
"key": "software_version",
"value": "1.2.3",
"label": "Software Version",
"visible": true
}
],
"content": {
"raw": "[log file content...]",
"parsed": [ /* parsed log entries */ ],
"insights": { "problems": [ /* detected problems */ ], "information": [ /* detected information */ ] }
}
}
{
"success": false,
"error": "Log not found."
}
| Header | Example | Description |
|---|---|---|
| Authorization | Authorization: Bearer 78351fafe495398163f... | The type (always "Bearer") and the log token received when creating the log. |
{
"success": true
}
{
"success": false,
"error": "Invalid token."
}
"6wexMDE",
"token" => "78351fafe495398163fff847f9a26dda440435dcf7b5f92e8e36308f3683d771"
],
[
"id" => "OahzhMG",
"token" => "6520dd42ec3d5fd0e83f28220974fb83d3bdc0746853f5022373f8e5b062651b"
],
], JSON_PRETTY_PRINT); ?>
207,
indicating that the request was processed.
Results for the individual operations are included in the response body.
addResponse("6wexMDE", new ApiResponse())
->addResponse("OahzhMG", new ApiResponse()), JSON_PRETTY_PRINT); ?>
addResponse("6wexMDE", new ApiResponse())
->addResponse("OahzhMG", new ApiError(404, "Log not found.")), JSON_PRETTY_PRINT); ?>
{
"success": false,
"error": "No logs provided."
}
| Field | Type | Description |
|---|---|---|
| [id] | string | The log file id, received from the paste endpoint or from a URL (toString()); ?>/[id]). |
[18:25:33] [Server thread/INFO]: Starting minecraft server version 1.16.2 [18:25:33] [Server thread/INFO]: Loading properties [18:25:34] [Server thread/INFO]: Default game type: SURVIVAL ...
{
"success": false,
"error": "Log not found."
}
| Field | Type | Description |
|---|---|---|
| [id] | string | The log file id, received from the paste endpoint or from a URL (toString()); ?>/[id]). |
{
"id": "name/type",
"name": "Software name, e.g. Vanilla",
"type": "Type name, e.g. Server Log",
"version": "Version, e.g. 1.12.2",
"title": "Combined title, e.g. Vanilla 1.12.2 Server Log",
"analysis": {
"problems": [
{
"message": "A message explaining the problem.",
"counter": 1,
"entry": {
"level": 6,
"time": null,
"prefix": "The prefix of this entry, usually the part containing time and loglevel.",
"lines": [
{
"number": 1,
"content": "The full content of the line."
}
]
},
"solutions": [
{
"message": "A message explaining a possible solution."
}
]
}
],
"information": [
{
"message": "Label: value",
"counter": 1,
"label": "The label of this information, e.g. Minecraft version",
"value": "The value of this information, e.g. 1.12.2",
"entry": {
"level": 6,
"time": null,
"prefix": "The prefix of this entry, usually the part containing time and loglevel.",
"lines": [
{
"number": 6,
"content": "The full content of the line."
}
]
}
}
]
}
}
{
"success": false,
"error": "Log not found."
}
If you only want to use the analysis features of this service without saving the log, you can use this endpoint. Please do not save logs that you only want to analyse, as this wastes storage space and resources.
| Field | Type | Description |
|---|---|---|
| content | string | The raw log file content as string. Maximum length is 10MiB and 25k lines, will be shortened if necessary. |
{
"id": "name/type",
"name": "Software name, e.g. Vanilla",
"type": "Type name, e.g. Server Log",
"version": "Version, e.g. 1.12.2",
"title": "Combined title, e.g. Vanilla 1.12.2 Server Log",
"analysis": {
"problems": [
{
"message": "A message explaining the problem.",
"counter": 1,
"entry": {
"level": 6,
"time": null,
"prefix": "The prefix of this entry, usually the part containing time and loglevel.",
"lines": [
{
"number": 1,
"content": "The full content of the line."
}
]
},
"solutions": [
{
"message": "A message explaining a possible solution."
}
]
}
],
"information": [
{
"message": "Label: value",
"counter": 1,
"label": "The label of this information, e.g. Minecraft version",
"value": "The value of this information, e.g. 1.12.2",
"entry": {
"level": 6,
"time": null,
"prefix": "The prefix of this entry, usually the part containing time and loglevel.",
"lines": [
{
"number": 6,
"content": "The full content of the line."
}
]
}
}
]
}
}
{
"success": false,
"error": "Required field 'content' is empty."
}
{
"storageTime": 7776000,
"maxLength": 10485760,
"maxLines": 25000
}
| Field | Type | Description |
|---|---|---|
| storageTime | integer | The duration in seconds that a log is stored for after the last view. |
| maxLength | integer | Maximum file length in bytes. Logs over this limit will be truncated to this length. |
| maxLines | integer | Maximum number of lines. Additional lines will be removed. |
Filters modify the log content before storing it. They are applied automatically when creating a new log on the server side. You can get a list of active filters from this endpoint if you want to apply the same filters on the client side before uploading a log.
| Type | Description |
|---|---|
| trim | Trim any whitespace characters from the beginning and end of the log content. |
| limit-bytes | Limit the log content to a maximum number of bytes (data.limit). Content exceeding this limit will be truncated. |
| limit-lines | Limit the log content to a maximum number of lines (data.limit). Additional lines will be removed. |
| regex | Apply regular expression replacements to the log content. Each pattern in data.patterns will be applied in order and replaced with the provided replacement, unless the matched string matches one of the exemption patterns in data.exemptions. |
The API has currently a rate limit of 60 requests per minute per IP address. This is set to ensure the operability of this service. If you have any use case that requires a higher limit, feel free to contact us.
Paste or drop your log here