org.apache.flink.runtime.webmonitor

Interface RestfulGateway

All Superinterfaces:

RpcGateway

All Known Subinterfaces:

DispatcherGateway, JobManagerGateway

All Known Implementing Classes:

AkkaJobManagerGateway, Dispatcher, MiniDispatcher, StandaloneDispatcher

public interface RestfulGateway
extends RpcGateway

Gateway for restful endpoints.

Gateways which implement this method run a REST endpoint which is reachable under the returned address.

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Acknowledge>	cancelJob(org.apache.flink.api.common.JobID jobId, org.apache.flink.api.common.time.Time timeout) Cancel the given job.
default CompletableFuture<Acknowledge>	disposeSavepoint(String savepointPath, org.apache.flink.api.common.time.Time timeout) Dispose the given savepoint.
CompletableFuture<ClusterOverview>	requestClusterOverview(org.apache.flink.api.common.time.Time timeout) Requests the cluster status overview.
CompletableFuture<? extends AccessExecutionGraph>	requestJob(org.apache.flink.api.common.JobID jobId, org.apache.flink.api.common.time.Time timeout) Requests the AccessExecutionGraph for the given jobId.
CompletableFuture<JobResult>	requestJobResult(org.apache.flink.api.common.JobID jobId, org.apache.flink.api.common.time.Time timeout) Requests the JobResult of a job specified by the given jobId.
default CompletableFuture<JobStatus>	requestJobStatus(org.apache.flink.api.common.JobID jobId, org.apache.flink.api.common.time.Time timeout) Request the JobStatus of the given job.
CompletableFuture<Collection<String>>	requestMetricQueryServicePaths(org.apache.flink.api.common.time.Time timeout) Requests the paths for the MetricQueryService to query.
CompletableFuture<MultipleJobsDetails>	requestMultipleJobDetails(org.apache.flink.api.common.time.Time timeout) Requests job details currently being executed on the Flink cluster.
default CompletableFuture<OperatorBackPressureStatsResponse>	requestOperatorBackPressureStats(org.apache.flink.api.common.JobID jobId, JobVertexID jobVertexId) Requests the statistics on operator back pressure.
CompletableFuture<String>	requestRestAddress(org.apache.flink.api.common.time.Time timeout) Requests the REST address of this RpcEndpoint.
CompletableFuture<Collection<org.apache.flink.api.java.tuple.Tuple2<ResourceID,String>>>	requestTaskManagerMetricQueryServicePaths(org.apache.flink.api.common.time.Time timeout) Requests the paths for the TaskManager's MetricQueryService to query.
default CompletableFuture<Acknowledge>	rescaleJob(org.apache.flink.api.common.JobID jobId, int newParallelism, RescalingBehaviour rescalingBehaviour, org.apache.flink.api.common.time.Time timeout) Trigger rescaling of the given job.
default CompletableFuture<Acknowledge>	shutDownCluster()
CompletableFuture<Acknowledge>	stopJob(org.apache.flink.api.common.JobID jobId, org.apache.flink.api.common.time.Time timeout) Stop the given job.
default CompletableFuture<String>	triggerSavepoint(org.apache.flink.api.common.JobID jobId, String targetDirectory, boolean cancelJob, org.apache.flink.api.common.time.Time timeout) Triggers a savepoint with the given savepoint directory as a target.

Methods inherited from interface org.apache.flink.runtime.rpc.RpcGateway

getAddress, getHostname

Method Detail

cancelJob

CompletableFuture<Acknowledge> cancelJob(org.apache.flink.api.common.JobID jobId,
                                         org.apache.flink.api.common.time.Time timeout)

Cancel the given job.

Parameters:

jobId - identifying the job to cancel

timeout - of the operation

Returns:

A future acknowledge if the cancellation succeeded

stopJob

CompletableFuture<Acknowledge> stopJob(org.apache.flink.api.common.JobID jobId,
                                       org.apache.flink.api.common.time.Time timeout)

Stop the given job.

Parameters:

jobId - identifying the job to stop

timeout - of the operation

Returns:

A future acknowledge if the stopping succeeded

requestRestAddress

CompletableFuture<String> requestRestAddress(org.apache.flink.api.common.time.Time timeout)

Requests the REST address of this RpcEndpoint.

Parameters:

timeout - for this operation

Returns:

Future REST endpoint address

requestJob

CompletableFuture<? extends AccessExecutionGraph> requestJob(org.apache.flink.api.common.JobID jobId,
                                                             org.apache.flink.api.common.time.Time timeout)

Requests the AccessExecutionGraph for the given jobId. If there is no such graph, then the future is completed with a FlinkJobNotFoundException.

Parameters:

jobId - identifying the job whose AccessExecutionGraph is requested

timeout - for the asynchronous operation

Returns:

Future containing the AccessExecutionGraph for the given jobId, otherwise FlinkJobNotFoundException

requestJobResult

CompletableFuture<JobResult> requestJobResult(org.apache.flink.api.common.JobID jobId,
                                              org.apache.flink.api.common.time.Time timeout)

Requests the JobResult of a job specified by the given jobId.

Parameters:

jobId - identifying the job for which to retrieve the JobResult.

timeout - for the asynchronous operation

Returns:

Future which is completed with the job's JobResult once the job has finished

requestMultipleJobDetails

CompletableFuture<MultipleJobsDetails> requestMultipleJobDetails(org.apache.flink.api.common.time.Time timeout)

Requests job details currently being executed on the Flink cluster.

Parameters:

timeout - for the asynchronous operation

Returns:

Future containing the job details

requestClusterOverview

CompletableFuture<ClusterOverview> requestClusterOverview(org.apache.flink.api.common.time.Time timeout)

Requests the cluster status overview.

Parameters:

timeout - for the asynchronous operation

Returns:

Future containing the status overview

requestMetricQueryServicePaths

CompletableFuture<Collection<String>> requestMetricQueryServicePaths(org.apache.flink.api.common.time.Time timeout)

Requests the paths for the MetricQueryService to query.

Parameters:

timeout - for the asynchronous operation

Returns:

Future containing the collection of metric query service paths to query

requestTaskManagerMetricQueryServicePaths

CompletableFuture<Collection<org.apache.flink.api.java.tuple.Tuple2<ResourceID,String>>> requestTaskManagerMetricQueryServicePaths(org.apache.flink.api.common.time.Time timeout)

Requests the paths for the TaskManager's MetricQueryService to query.

Parameters:

timeout - for the asynchronous operation

Returns:

Future containing the collection of instance ids and the corresponding metric query service path

triggerSavepoint

default CompletableFuture<String> triggerSavepoint(org.apache.flink.api.common.JobID jobId,
                                                   String targetDirectory,
                                                   boolean cancelJob,
                                                   org.apache.flink.api.common.time.Time timeout)

Triggers a savepoint with the given savepoint directory as a target.

Parameters:

jobId - ID of the job for which the savepoint should be triggered.

targetDirectory - Target directory for the savepoint.

timeout - Timeout for the asynchronous operation

Returns:

A future to the external pointer of the savepoint.

disposeSavepoint

default CompletableFuture<Acknowledge> disposeSavepoint(String savepointPath,
                                                        org.apache.flink.api.common.time.Time timeout)

Dispose the given savepoint.

Parameters:

savepointPath - identifying the savepoint to dispose

timeout - RPC timeout

Returns:

A future acknowledge if the disposal succeeded

requestJobStatus

default CompletableFuture<JobStatus> requestJobStatus(org.apache.flink.api.common.JobID jobId,
                                                      org.apache.flink.api.common.time.Time timeout)

Request the JobStatus of the given job.

Parameters:

jobId - identifying the job for which to retrieve the JobStatus

timeout - for the asynchronous operation

Returns:

A future to the JobStatus of the given job

requestOperatorBackPressureStats

default CompletableFuture<OperatorBackPressureStatsResponse> requestOperatorBackPressureStats(org.apache.flink.api.common.JobID jobId,
                                                                                              JobVertexID jobVertexId)

Requests the statistics on operator back pressure.

Parameters:

jobId - Job for which the stats are requested.

jobVertexId - JobVertex for which the stats are requested.

Returns:

A Future to the OperatorBackPressureStatsResponse or null if the stats are not available (yet).

rescaleJob

default CompletableFuture<Acknowledge> rescaleJob(org.apache.flink.api.common.JobID jobId,
                                                  int newParallelism,
                                                  RescalingBehaviour rescalingBehaviour,
                                                  org.apache.flink.api.common.time.Time timeout)

Trigger rescaling of the given job.

Parameters:

jobId - specifying the job to rescale

newParallelism - new parallelism of the job

rescalingBehaviour - defining how strict the rescaling has to be executed

timeout - of this operation

Returns:

Future which is completed with Acknowledge once the rescaling was successful

shutDownCluster

default CompletableFuture<Acknowledge> shutDownCluster()