This is the Container service operational guide.
Note that "container" is an overloaded concept in Vespa - in this guide it refers to service instance nodes in blue.
Container service(s) hosts the query and feed endpoints - examples:
are located in separate clusters in the second example, and endpoints are therefore different.
Please see Metrics for general information on metrics in Vespa.
Metrics from the container with description and unit can be found in Container Metrics. The most commonly used metrics are mentioned below.
These metrics are output for the server as a whole, e.g. related to resources. Some metrics indicate memory usage, such as
mem.direct.*. Other metics are related to the JVM garbage
Metrics for the container thread pools.
jdisc.thread_pool.* metrics have a dimension
threadpool with thread pool name,
e.g default-pool for the container's default thread pool.
See Container Tuning for details.
These are metrics specific for HTTP. Those metrics that are specific to a connector will have a dimension containing the TCP listen port.
Refer to Container Metrics
for metrics on HTTP status response codes,
http.status.* or more detailed requests related to the handling
jdisc.http.*. Other relevant metrics include
For metrics related to queries please start with the
handled.latency or the
httpapi_* metrics for more insights.
For metrics related to feeding into Vespa we recommend using the
Determine the state of each running Java Vespa service using JConsole. JConsole is distributed along with the Java developer kit. Start JConsole:
$ jconsole <host>:<port>
where the host and port determine which service to attach to. For security purposes the JConsole tool can not directly attach to Vespa services from external machines.
To attach a JConsole to a Vespa service running on another host, create a tunnel from the JConsole host to the Vespa service host. This can for example be done by setting up two SSH tunnels as follows:
$ ssh -N -L<port1>:localhost:<port1> <service-host> & $ ssh -N -L<port2>:localhost:<port2> <service-host> &
where port1 and port2 are determined by the type of service (see below). A JConsole can then be attached to the service as follows:
$ jconsole localhost:<port1>
|Service||Port 1||Port 2|
Updated port information can be found by running:
$ vespa-model-inspect service <servicename>
where the resulting RMIREGISTRY and JMX lines determine port1 and port2, respectively.
The state of each container is available in JConsole by pressing the Threads tab and selecting the thread of interest in the threads list. Threads of interest includes search, connector, closer, transport and acceptor (the latter four are used for backend communications).