# groonga - An open-source fulltext search engine and column store.

- 日本語

# 7.3.56. `status`

## 7.3.56.1. Summary

`status` returns the current status of the context that processes the request.

Context is an unit that processes requests. Normally, context is created for each thread.

## 7.3.56.2. Syntax

This command takes no parameters:

    status

## 7.3.56.3. Usage

Here is a simple example:

Execution example:

    status
    # [
    #   [
    #     0,
    #     1337566253.89858,
    #     0.000355720520019531
    #   ],
    #   {
    #     "uptime": 1,
    #     "max_command_version": 3,
    #     "start_time": 1514345928,
    #     "cache_hit_rate": 0.0,
    #     "version": "7.0.9",
    #     "alloc_count": 13365,
    #     "command_version": 1,
    #     "starttime": 1514345928,
    #     "default_command_version": 1,
    #     "n_queries": 0
    #   }
    # ]

It returns the current status of the context that processes the request. See Return value for details.

## 7.3.56.4. Parameters

This section describes all parameters.

### 7.3.56.4.1. Required parameters

There is no required parameter.

### 7.3.56.4.2. Optional parameters

There is no optional parameter.

## 7.3.56.5. Return value

The command returns the current status as an object:

    [
      HEADER,
      {
        "alloc_count": ALLOC_COUNT,
        "cache_hit_rate": CACHE_HIT_RATE,
        "command_version": COMMAND_VERSION,
        "default_command_version": DEFAULT_COMMAND_VERSION,
        "max_command_version": MAX_COMMAND_VERSION,
        "n_queries": N_QUERIES,
        "start_time": START_TIME,
        "starttime": STARTTIME,
        "uptime": UPTIME,
        "version": VERSION
      }
    ]

See Output format for `HEADER`.

Here are descriptions about values. See Usage for real values:

Key | Description | Example
--- | --- | ---
`alloc_count` | The number of allocated memory blocks that aren’t freed. If this value is continuously increased, there may be a memory leak. | `1400`
`cache_hit_rate` | Percentage of cache used responses in the Groonga process. If there are 10 requests and 7 responses are created from cache, `cache_hit_rate` is `70.0`. The percentage is computed from only requests that use commands that support cache. Here are commands that support cache: select logical_select logical_range_filter logical_count | `29.4`
`command_version` | The Command version that is used by the context. | `1`
`default_command_version` | The default Command version of the Groonga process. | `1`
`max_command_version` | The max Command version of the Groonga process. | `2`
`n_queries` | The number of requests processed by the Groonga process. It counts only requests that use commands that support cache. Here are commands that support cache: select logical_select logical_range_filter logical_count | `29`
`start_time` | New in version 5.0.8. The time that the Groonga process started in UNIX time. | `1441761403`
`starttime` | Deprecated since version 5.0.8: Use `start_time` instead. | `1441761403`
`uptime` | The elapsed time since the Groonga process started in second. For example, `216639` means that `2.5` (= `216639 / 60 / 60 / 24 = 2.507`) days. | `216639`
`version` | The version of the Groonga process. | `5.0.7`