The logsReadLines Web API Method

Read a certain number of log lines from the end of the file log. If serverId is passed, then the request will be performed against that cluster member, otherwise it is performed locally.

Version: 1.3

Required Permissions: Read-Only

HTTP method: GET

Supported by Editions: Zend Server

Request Parameters:  

Parameter

 Type

Required

Description

logName

String

Yes

One of the following values:

codetracing, datacache, deployment, dserver, jobqueue, jqd, monitor, monitor_node, monitor_ui, pagecache, php, sc, scd, statistics, utils, zdd, zem, zsd, php

serverId

Integer

No

If passed, the log contents will be fetched from that cluster member, otherwise performed locally.

linesToRead

Integer

No

How many lines to read. defaults to a certain system-wide configurable setting. Limited by another such setting.

filter

String

No

Apply a certain case-insensitive string filter to the log lines.

Expected Response Code: 200 OK.

Response Format: The response contains some metadata fields, and the log lines content

Possible Action Specific Error Codes:

HTTP Code

Error Code

Description

400

invalidParameter

Could be as of non-recognized logName, non-existent serverId etc.

404

logFileNotReadable

Log file was not found / missing read permissions

500

internalServerError

Operation against remote server failed.

Example

Usage Example

Request (headers removed for the purpose of clarity)

GET /ZendServer/Api/logsReadLines?logname=zdd&filter=error

Response (not all headers are shown)

HTTP/1.0 200 OK

<?xml version="1.0" encoding="UTF-8"?>

<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.3">

<requestData>

<apiKeyName><![CDATA[Admin]]></apiKeyName>

<method>logsReadLines</method>

</requestData>

<responseData>

<logFileMetaData>

<lineNumber>896</lineNumber>

<fileSize>152124</fileSize>

<lastModified>2012-07-30T07:44:27+00:00</lastModified>

</logFileMetaData>

<logFileLines><![CDATA[[19-Jun-2012 06:14:34 UTC] PHP Fatal error: Call to undefined method stdClass::saveXML() in /home/tmak/zs_auto/scraplandia/scrap.php on line 15

[22-Jul-2012 10:05:01 UTC] PHP Fatal error: Uncaught exception &#039;Exception&#039; with message &#039;DateTime::__construct(): Failed to parse time string (1342951501) at position 8 (0): Unexpected character&#039; in /home/tmak/zs_auto/scraplandia/scrap.php:15

]]>

</logFileLines>

</responseData>

</zendServerAPIResponse>