NAME

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

VERSION

version 1.00

DESCRIPTION

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 Elasticsearch::Role::Client::Direct.

METHODS

help()

    say $e->cat->help;

Returns the list of supported cat APIs

aliases()

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

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

Query string parameters: h, help, local, master_timeout, v

See the cat aliases docs for more information.

allocation()

    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, h, help, local, master_timeout, v

See the cat allocation docs for more information.

count()

    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: h, help, local, master_timeout, v

See the cat count docs for more information.

health()

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

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

Query string parameters: bytes, h, help, local, master_timeout, ts, v

See the cat health docs for more information.

indices()

    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, h, help, local, master_timeout, pri, v

See the cat indices docs for more information.

master()

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

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

Query string parameters: h, help, local, master_timeout, v

See the cat master docs for more information.

nodes()

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

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

Query string parameters: h, help, local, master_timeout, v

See the cat nodes docs for more information.

pending_tasks()

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

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

Query string parameters: local, master_timeout, h, help, v

See the cat pending-tasks docs for more information.

recovery()

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

Provides a is 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, h, help, local, master_timeout, v

See the cat recovery docs for more information.

shards()

    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: h, help, local, master_timeout, v

See the cat shards docs for more information.

    "cat.shards" => {
        doc  => "cat-shards",
        path => "/_cat/shards/{index}",
        qs   => [ "local", "master_timeout", "h", "help", "v" ],
    },

AUTHOR

Clinton Gormley <drtech@cpan.org>

COPYRIGHT AND LICENSE

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

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004

cpanm Elasticsearch

perl -MCPAN -e shell
install Elasticsearch