GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Search::Elasticsearch::Client::5_0::Direct::Cat(3) User Contributed Perl Documentation Search::Elasticsearch::Client::5_0::Direct::Cat(3)

Search::Elasticsearch::Client::5_0::Direct::Cat - A client for running cat debugging requests

version 6.00

The "cat" API in Elasticsearch provides information about your cluster and indices in a simple, easy to read text format, intended for human consumption.

These APIs have a number of parameters in common:

  • "help"

    Returns help about the API, eg:

        say $e->cat->allocation(help => 1);
        
  • "v"

    Includes the column headers in the output:

        say $e->cat->allocation(v => 1);
        
  • "h"

    Accepts a list of column names to be output, eg:

        say $e->cat->indices(h => ['health','index']);
        
  • "bytes"

    Formats byte-based values as bytes ("b"), kilobytes ("k"), megabytes ("m") or gigabytes ("g")

It does Search::Elasticsearch::Role::Client::Direct.

    say $e->cat->help;

Returns the list of supported "cat" APIs

    say $e->cat->aliases(
        name => 'name' | \@names    # optional
    );

Returns information about index aliases, optionally limited to the specified index/alias names.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat aliases docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-aliases.html> for more information.

    say $e->cat->allocation(
        node_id => 'node' | \@nodes    # optional
    );

Provides a snapshot of how shards have located around the cluster and the state of disk usage.

Query string parameters: "bytes", "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat allocation docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-allocation.html> for more information.

    say $e->cat->count(
        index => 'index' | \@indices    # optional
    );

Provides quick access to the document count of the entire cluster, or individual indices.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat count docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-count.html> for more information.

    say $e->cat->fielddata(
        fields => 'field' | \@fields    # optional
    );

Shows the amount of memory used by each of the specified `fields` (or all fields) loaded into fielddata.

Query string parameters: "bytes", "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat fielddata docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-fielddata.html> for more information.

    say $e->cat->health();

Provides a snapshot of how shards have located around the cluster and the state of disk usage.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "ts", "s", "v"

See the cat health docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-health.html> for more information.

    say $e->cat->indices(
        index => 'index' | \@indices    # optional
    );

Provides a summary of index size and health for the whole cluster or individual indices

Query string parameters: "bytes", "error_trace", "format", "h", "health", "help", "human", "local", "master_timeout", "pri", "s", "v"

See the cat indices docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-indices.html> for more information.

    say $e->cat->master();

Displays the master’s node ID, bound IP address, and node name.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat master docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-master.html> for more information.

    say $e->cat->nodeattrs();

Returns the node attributes set per node.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat nodeattrs docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-nodeattrs.html> for more information.

    say $e->cat->nodes();

Provides a snapshot of all of the nodes in your cluster.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat nodes docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-nodes.html> for more information.

    say $e->cat->pending_tasks();

Returns any cluster-level tasks which are queued on the master.

Query string parameters: "error_trace", "format", "human", "local", "master_timeout", "h", "help", "s", "v"

See the cat pending-tasks docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-pending-tasks.html> for more information.

    say $e->cat->plugins();

Returns information about plugins installed on each node.

Query string parameters: "error_trace", "format", "human", "local", "master_timeout", "h", "help", "s", "v"

See the cat plugins docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-plugins.html> for more information.

    say $e->cat->recovery(
        index => 'index' | \@indices    # optional
    );

Provides a view of shard replication. It will show information anytime data from at least one shard is copying to a different node. It can also show up on cluster restarts. If your recovery process seems stuck, try it to see if there’s any movement using "recovery()".

Query string parameters: "bytes", "error_trace", "format", "h", "help", "human", "master_timeout", "s", "v"

See the cat recovery docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-recovery.html> for more information.

    say $e->cat->repositories()

Provides a list of registered snapshot repositories.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat repositories docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-repositories.html> for more information.

    say $e->cat->segments(
        index => 'index' | \@indices    # optional
    );

Provides low level information about the segments in the shards of an index.

Query string parameters: "bytes", "error_trace", "format", "h", "help", "human", "s", "v"

See the cat shards docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-segments.html> for more information.

    say $e->cat->shards(
        index => 'index' | \@indices    # optional
    );

Provides a detailed view of what nodes contain which shards, the state and size of each shard.

Query string parameters: "bytes", "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat shards docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-shards.html> for more information.

    say $e->cat->snapshots(
        repository => 'repository' | \@repositories # required
    )

Provides a list of all snapshots that belong to the specified repositories.

Query string parameters: "error_trace", "format", "h", "help", "human", "ignore_unavailable", "master_timeout", "s", "v"

See the cat snapshots docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-snapshots.html> for more information.

    say $e->cat->tasks()

Provides a list of node-level tasks.

Query string parameters: "actions", "detailed", "error_trace", "format", "h", "help", "human", "node_id", "parent_node", "parent_task", "s", "v"

See the cat tasks docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/tasks.html> for more information.

    say $e->cat->templates(
        name => $name # optional
    )

Provides a list of index templates.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "s", "v"

See the cat templates docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/templates.html> for more information.

    say $e->cat->thread_pool(
        index => 'index' | \@indices    # optional
    );

Shows cluster wide thread pool statistics per node. By default the "active", "queue" and "rejected" statistics are returned for the "bulk", "index" and "search" thread pools.

Query string parameters: "error_trace", "format", "h", "help", "human", "local", "master_timeout", "size", "s", "v"

See the cat thread_pool docs <http://www.elastic.co/guide/en/elasticsearch/reference/current/cat-thread-pool.html> for more information.

Clinton Gormley <drtech@cpan.org>

This software is Copyright (c) 2017 by Elasticsearch BV.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004
2017-11-14 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.