org.apache.hadoop.yarn.server.webapp

Class LogWebService

java.lang.Object

org.apache.hadoop.yarn.server.webapp.LogWebService

All Implemented Interfaces:

AppInfoProvider

@Path(value="/ws/v2/applicationlog")
public class LogWebService
extends Object
implements AppInfoProvider

Support only ATSv2 client only.

Constructor Summary

Constructors

Constructor and Description
LogWebService()

Method Summary

Modifier and Type	Method and Description
org.apache.hadoop.yarn.server.webapp.BasicAppInfo	getApp(javax.servlet.http.HttpServletRequest req, String appId, String clusterId) Returns BasicAppInfo object that wraps the collected information about the application.
javax.ws.rs.core.Response	getContainerLogFile(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, String containerIdStr, String filename, String format, String size, String nmId, boolean redirectedFromNode, String clusterId, boolean manualRedirection) Returns the contents of a container's log file in plain text.
javax.ws.rs.core.Response	getContainerLogsInfo(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, String containerIdStr, String nmId, boolean redirectedFromNode, String clusterId, boolean manualRedirection) Returns log file's name as well as current file size for a container.
protected org.apache.hadoop.yarn.api.records.timelineservice.TimelineEntity	getEntity(String path, javax.ws.rs.core.MultivaluedMap<String,String> params)
javax.ws.rs.core.Response	getLogs(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, String containerIdStr, String filename, String format, String size, String nmId, boolean redirectedFromNode, String clusterId, boolean manualRedirection)
String	getNodeHttpAddress(javax.servlet.http.HttpServletRequest req, String appId, String appAttemptId, String containerId, String clusterId) Returns the node HTTP address.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LogWebService

public LogWebService()

Method Detail

getContainerLogsInfo

@GET
 @Path(value="/containers/{containerid}/logs")
 @Produces(value={"application/json","application/xml"})
public javax.ws.rs.core.Response getContainerLogsInfo(@Context
                                                                                                                                                                   javax.servlet.http.HttpServletRequest req,
                                                                                                                                                                   @Context
                                                                                                                                                                   javax.servlet.http.HttpServletResponse res,
                                                                                                                                                                   @PathParam(value="containerid")
                                                                                                                                                                   String containerIdStr,
                                                                                                                                                                   @QueryParam(value="nm.id")
                                                                                                                                                                   String nmId,
                                                                                                                                                                   @QueryParam(value="redirected_from_node") @DefaultValue(value="false")
                                                                                                                                                                   boolean redirectedFromNode,
                                                                                                                                                                   @QueryParam(value="clusterid")
                                                                                                                                                                   String clusterId,
                                                                                                                                                                   @QueryParam(value="manual_redirection") @DefaultValue(value="false")
                                                                                                                                                                   boolean manualRedirection)

Returns log file's name as well as current file size for a container.

Parameters:

req - HttpServletRequest

res - HttpServletResponse

containerIdStr - The container ID

nmId - The Node Manager NodeId

redirectedFromNode - Whether this is a redirected request from NM

Returns:

The log file's name and current file size

getNodeHttpAddress

public String getNodeHttpAddress(javax.servlet.http.HttpServletRequest req,
                                 String appId,
                                 String appAttemptId,
                                 String containerId,
                                 String clusterId)

Description copied from interface: AppInfoProvider

Returns the node HTTP address.

Specified by:

getNodeHttpAddress in interface AppInfoProvider

Parameters:

req - HttpServletRequest associated with the request

appId - the id of the application

appAttemptId - the id of the application attempt

containerId - the container id

clusterId - the id of the cluster

Returns:

the node HTTP address

getApp

public org.apache.hadoop.yarn.server.webapp.BasicAppInfo getApp(javax.servlet.http.HttpServletRequest req,
                                                                String appId,
                                                                String clusterId)

Description copied from interface: AppInfoProvider

Returns BasicAppInfo object that wraps the collected information about the application.

Specified by:

getApp in interface AppInfoProvider

Parameters:

req - HttpServletRequest associated with the request

appId - the id of the application

clusterId - the id of the cluster

Returns:

BasicAppInfo object

getContainerLogFile

@GET
 @Path(value="/containers/{containerid}/logs/{filename}")
 @Produces(value="text/plain")
 @InterfaceAudience.Public
 @InterfaceStability.Unstable
public javax.ws.rs.core.Response getContainerLogFile(@Context
                                                                                                                                                                                                            javax.servlet.http.HttpServletRequest req,
                                                                                                                                                                                                            @Context
                                                                                                                                                                                                            javax.servlet.http.HttpServletResponse res,
                                                                                                                                                                                                            @PathParam(value="containerid")
                                                                                                                                                                                                            String containerIdStr,
                                                                                                                                                                                                            @PathParam(value="filename")
                                                                                                                                                                                                            String filename,
                                                                                                                                                                                                            @QueryParam(value="format")
                                                                                                                                                                                                            String format,
                                                                                                                                                                                                            @QueryParam(value="size")
                                                                                                                                                                                                            String size,
                                                                                                                                                                                                            @QueryParam(value="nm.id")
                                                                                                                                                                                                            String nmId,
                                                                                                                                                                                                            @QueryParam(value="redirected_from_node")
                                                                                                                                                                                                            boolean redirectedFromNode,
                                                                                                                                                                                                            @QueryParam(value="clusterid")
                                                                                                                                                                                                            String clusterId,
                                                                                                                                                                                                            @QueryParam(value="manual_redirection") @DefaultValue(value="false")
                                                                                                                                                                                                            boolean manualRedirection)

Returns the contents of a container's log file in plain text.

Parameters:

req - HttpServletRequest

res - HttpServletResponse

containerIdStr - The container ID

filename - The name of the log file

format - The content type

size - the size of the log file

nmId - The Node Manager NodeId

redirectedFromNode - Whether this is the redirect request from NM

Returns:

The contents of the container's log file

getLogs

@GET
 @Path(value="/containerlogs/{containerid}/{filename}")
 @Produces(value="text/plain; charset=utf-8")
 @InterfaceAudience.Public
 @InterfaceStability.Unstable
public javax.ws.rs.core.Response getLogs(@Context
                                                                                                                                                                                                             javax.servlet.http.HttpServletRequest req,
                                                                                                                                                                                                             @Context
                                                                                                                                                                                                             javax.servlet.http.HttpServletResponse res,
                                                                                                                                                                                                             @PathParam(value="containerid")
                                                                                                                                                                                                             String containerIdStr,
                                                                                                                                                                                                             @PathParam(value="filename")
                                                                                                                                                                                                             String filename,
                                                                                                                                                                                                             @QueryParam(value="format")
                                                                                                                                                                                                             String format,
                                                                                                                                                                                                             @QueryParam(value="size")
                                                                                                                                                                                                             String size,
                                                                                                                                                                                                             @QueryParam(value="nm.id")
                                                                                                                                                                                                             String nmId,
                                                                                                                                                                                                             @QueryParam(value="redirected_from_node") @DefaultValue(value="false")
                                                                                                                                                                                                             boolean redirectedFromNode,
                                                                                                                                                                                                             @QueryParam(value="clusterid")
                                                                                                                                                                                                             String clusterId,
                                                                                                                                                                                                             @QueryParam(value="manual_redirection") @DefaultValue(value="false")
                                                                                                                                                                                                             boolean manualRedirection)

getEntity

protected org.apache.hadoop.yarn.api.records.timelineservice.TimelineEntity getEntity(String path,
                                                                                      javax.ws.rs.core.MultivaluedMap<String,String> params)
                                                                               throws IOException

Throws:

IOException