zc.z3monitor 0.8.0

进程信息

要获取关于进程整体的信息，请使用监控命令

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('help monitor\n')
Help for monitor:
<BLANKLINE>
Get general process info
<BLANKLINE>
    The minimal output has:
<BLANKLINE>
    - The number of open database connections to the main database, which
      is the database registered without a name.
    - The virtual memory size, and
    - The resident memory size.
<BLANKLINE>
    If there are old database connections, they will be listed.  By
    default, connections are considered old if they are greater than 100
    seconds old. You can pass a minimum old connection age in seconds.
    If you pass a value of 0, you'll see all connections.
<BLANKLINE>
    If you pass a name after the integer, this is used as the database name.
    The database name defaults to the empty string ('').
<BLANKLINE>
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('monitor\n') #doctest: +NORMALIZE_WHITESPACE
0
VmSize:        35284 kB
VmRSS:         28764 kB
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('monitor 100 other\n') #doctest: +NORMALIZE_WHITESPACE
0
VmSize:        35284 kB
VmRSS:         28764 kB
-> CLOSE

请注意，截至本文撰写时，VmSize 和 VmRSS 行仅在具有 procfs 的系统上存在。这通常包括许多种类的 Linux，不包括 OS X 和 Windows。

让我们创建一些连接，然后再次使用值为 0 的 z3monitor 命令

>>> conn1 = main.open()
>>> conn2 = main.open()

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('monitor 0\n') #doctest: +NORMALIZE_WHITESPACE
2
VmSize:        36560 kB
VmRSS:         28704 kB
0.0    (0)
0.0    (0)
-> CLOSE

额外的输出行提供了连接调试信息。如果我们设置一些额外的输入，我们将看到它

>>> conn1.setDebugInfo('/foo')
>>> conn2.setDebugInfo('/bar')

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('monitor 0\n') #doctest: +NORMALIZE_WHITESPACE
2
VmSize:        13048 kB
VmRSS:         10084 kB
0.0   /bar (0)
0.0   /foo (0)
-> CLOSE

>>> conn1.close()
>>> conn2.close()

数据库信息

要获取有关数据库的信息，请使用 dbinfo 命令

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('help dbinfo\n')
Help for dbinfo:
<BLANKLINE>
Get database statistics
<BLANKLINE>
    By default statistics are returned for the main database.  The
    statistics are returned as a single line consisting of the:
<BLANKLINE>
    - number of database loads
<BLANKLINE>
    - number of database stores
<BLANKLINE>
    - number of connections in the last five minutes
<BLANKLINE>
    - number of objects in the object caches (combined)
<BLANKLINE>
    - number of non-ghost objects in the object caches (combined)
<BLANKLINE>
    You can pass a database name, where "-" is an alias for the main database.
<BLANKLINE>
    By default, the statistics are for a sampling interval of 5
    minutes.  You can request another sampling interval, up to an
    hour, by passing a sampling interval in seconds after the database name.
<BLANKLINE>
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('dbinfo\n') #doctest: +NORMALIZE_WHITESPACE
0   0   2   0   0
-> CLOSE

让我们打开一个连接并做一些工作

>>> conn = main.open()
>>> conn.root()['a'] = 1
>>> import transaction
>>> transaction.commit()
>>> conn.root()['a'] = 1
>>> transaction.commit()
>>> conn.close()

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('dbinfo\n') #doctest: +NORMALIZE_WHITESPACE
1   2   3   1   1
-> CLOSE

您可以指定数据库名称。因此，要获取其他数据库的统计信息，我们将指定其注册时的名称

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('dbinfo other\n')  #doctest: +NORMALIZE_WHITESPACE
0   0   0   0   0
-> CLOSE

您可以使用“-”来命名主数据库

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('dbinfo -\n')  #doctest: +NORMALIZE_WHITESPACE
1   2   3   1   1
-> CLOSE

您可以指定要采样的秒数。例如，要获取最后 10 秒的数据

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('dbinfo - 10\n') #doctest: +NORMALIZE_WHITESPACE
1   2   3   1   1
-> CLOSE

ZEO 缓存统计

您可以使用 zeocache 命令获取 ZEO 缓存统计信息

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('help zeocache\n')
Help for zeocache:
<BLANKLINE>
Get ZEO client cache statistics
<BLANKLINE>
    The command returns data in a single line:
<BLANKLINE>
    - the number of records added to the cache,
<BLANKLINE>
    - the number of bytes added to the cache,
<BLANKLINE>
    - the number of records evicted from the cache,
<BLANKLINE>
    - the number of bytes evicted from the cache,
<BLANKLINE>
    - the number of cache accesses.
<BLANKLINE>
    By default, data for the main database are returned.  To return
    information for another database, pass the database name.
<BLANKLINE>
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('zeocache\n') #doctest: +NORMALIZE_WHITESPACE
42 4200 23 2300 1000
-> CLOSE

您可以指定数据库名称

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('zeocache other\n') #doctest: +NORMALIZE_WHITESPACE
42 4200 23 2300 1000
-> CLOSE

ZEO 连接状态

zeostatus 命令让您获取 ZEO 连接状态信息

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('help zeostatus\n')
Help for zeostatus:
<BLANKLINE>
Get ZEO client status information
<BLANKLINE>
    The command returns True if the client is connected and False otherwise.
<BLANKLINE>
    By default, data for the main database are returned.  To return
    information for another database, pass the database name.
<BLANKLINE>
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('zeostatus\n') #doctest: +NORMALIZE_WHITESPACE
True
-> CLOSE

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('zeostatus other\n') #doctest: +NORMALIZE_WHITESPACE
True
-> CLOSE

在此示例中，我们使用一个模拟的 ZEO 连接。它有一个属性来确定是否连接。如果我们更改它，则 zeocache 输出将更改

>>> main._storage._is_connected = False

>>> connection = zc.ngi.testing.TextConnection()
>>> server = zc.monitor.Server(connection)

>>> connection.test_input('zeostatus\n') #doctest: +NORMALIZE_WHITESPACE
False
-> CLOSE

0.8.0 (2012-02-21)

功能

• 添加了新产品配置选项 new bind product-config，以便绑定到特定地址/套接字。旧的端口仍然可用。

0.7.0 (2008-09-14)

0.6.0 (2008-09-14)

功能

• 新的 interactive 命令使连接可以继续通过多个命令，直到您使用 quit 命令。

• monitor 命令接受可选的数据库参数（在旧的长参数之后）。

0.5.0 (2008-4-4)

功能

• 如果请求的监控端口正在使用中，则记录并继续，而不是使用异常停止进程。这使得 zopectl debug 可以与运行实例一起工作。

0.4.1 (2008-3-31)

PyPI 的初始发布

0.4.0 (2007-11-29)

新功能

• 将 ZEO 缓存状态移动到 zeostatus 命令。

0.3.0 (2007-11-29)

新功能

• 命令现在作为工具提供。这意味着可以通过实现简单的工具来添加 z3monitor 命令。

• 添加了一个工作的 help 命令。

• 将 ZEO 连接状态添加到 zeocache 输出。

0.2.0 (2007-11-15)

新功能

• 添加了一个获取 ZEO 缓存统计信息的命令。