Zen

Translation

English
Go through the :ref:`C stored procedures <f_c_tutorial-c_stored_procedures>` tutorial. Replace the easy.c example with
В руководстве Tarantool по :ref:`хранимым процедурам на языке C <f_c_tutorial-c_stored_procedures>` перейдите к примеру с файлом ``easy.c``. Удалите содержимое файла и вставьте следующий код:
191/1180 · 118
English Russian Actions
overall number of aborted traces
общее количество прерванных трассировок
jit_trace_num
jit_trace_num
number of JIT traces
количество JIT-трассировок
strhash_hit
strhash_hit
number of strings being interned because, if a string with the same value is found via the hash, a new one is not created / allocated
количество интернированных строк (если строка уже есть в пуле, новая копия не создается и память под нее не выделяется)
strhash_miss
strhash_miss
total number of strings allocations during the platform lifetime
общее количество памяти, выделенной для строк за время жизни платформы
Note: Although value names are similar to value names in `ujit.getmetrics() <https://ujit.readthedocs.io/en/latest/public/ujit-024.html#ujit-getmetrics>`_ the values are not the same, primarily because many ujit numbers are not monotonic.
Примечание. Функция `ujit.getmetrics() <https://ujit.readthedocs.io/en/latest/public/ujit-024.html#ujit-getmetrics>`_ возвращает похожие имена. Однако многие значения, используемые в uJIT, не монотонны.
Note: Although value names are similar to value names in :ref:`LuaJIT metrics <metrics-reference-luajit>`, and the values are exactly the same, misc.getmetrics() is slightly easier because there is no need to ‘require’ the misc module.
Примечание. В :ref:`LuaJIT metrics <metrics-luajit>` используются похожие имена и аналогичные значения. Отличие функции misc.getmetrics() в том, что она не требует вызывать ``require`` для модуля misc.
getmetrics C API
C API для getmetrics
The Lua ``getmetrics()`` function is a wrapper for the C function ``luaM_metrics()``.
Lua-функция ``getmetrics()`` --- обертка для C-функции ``luaM_metrics()``.
C programs may include a header named ``libmisclib.h``. The definitions in ``libmisclib.h`` include the following lines:
Программы на C могут включать заголовок ``libmisclib.h``, куда входят следующие определения:
struct luam_Metrics { /* the names described earlier for Lua */ }

LUAMISC_API void luaM_metrics(lua_State *L, struct luam_Metrics *metrics);
struct luam_Metrics { /* имена, описанные ранее для Lua */ }

LUAMISC_API void luaM_metrics(lua_State *L, struct luam_Metrics *metrics);
The names of ``struct luam_Metrics`` members are the same as Lua's :ref:`getmetrics table values <luajit_getmetrics_tablevalues>` names. The data types of ``struct luam_Metrics`` members are all ``size_t``. The ``luaM_metrics()`` function will fill the ``*metrics`` structure with the metrics related to the Lua state anchored to the ``L`` coroutine.
Имена элементов структуры ``luam_Metrics`` совпадают с именами в :ref:`таблице значений getmetrics <luajit_getmetrics_tablevalues>` для Lua. У всех элементов структуры ``luam_Metrics`` тип данных — ``size_t``. Функция ``luaM_metrics()`` заполняет структуру ``*metrics`` метриками, относящимися к Lua-состоянию, которое связано с корутиной ``L``.
**Example with a C program**
**Пример с программой на языке C**
Go through the :ref:`C stored procedures <f_c_tutorial-c_stored_procedures>` tutorial. Replace the easy.c example with
В руководстве Tarantool по :ref:`хранимым процедурам на языке C <f_c_tutorial-c_stored_procedures>` перейдите к примеру с файлом ``easy.c``. Удалите содержимое файла и вставьте следующий код:
#include "module.h"
#include <lmisclib.h>

int easy(box_function_ctx_t *ctx, const char *args, const char *args_end)
{
lua_State *ls = luaT_state();
struct luam_Metrics m;
luaM_metrics(ls, &m);
printf("allocated memory = %lu\n", m.gc_allocated);
return 0;
}
#include "module.h"
#include <lmisclib.h>

int easy(box_function_ctx_t *ctx, const char *args, const char *args_end)
{
lua_State *ls = luaT_state();
struct luam_Metrics m;
luaM_metrics(ls, &m);
printf("allocated memory = %lu\n", m.gc_allocated);
return 0;
}
Now when you go back to the client and execute the requests up to and including the line ``capi_connection:call('easy')`` you will see that the display is something like "allocated memory = 4431950" although the number will vary.
Теперь, как в исходном примере, выполните через клиент запросы до ``capi_connection:call('easy')`` включительно. На экране появится следующее: ``allocated memory = 4431950`` (число приведено для примера).
Example with gc_strnum, strhash_miss, and strhash_hit
Пример с gc_strnum, strhash_miss и strhash_hit
To track new string object allocations:
Отслеживать размещение новых строковых объектов можно так:
function f()
collectgarbage("collect")
local oldm = misc.getmetrics()
local table_of_strings = {}
for i = 3000, 4000 do table.insert(table_of_strings, tostring(i)) end
for i = 3900, 4100 do table.insert(table_of_strings, tostring(i)) end
local newm = misc.getmetrics()
print("gc_strnum diff = " .. newm.gc_strnum - oldm.gc_strnum)
print("strhash_miss diff = " .. newm.strhash_miss - oldm.strhash_miss)
print("strhash_hit diff = " .. newm.strhash_hit - oldm.strhash_hit)
end
f()
function f()
collectgarbage("collect")
local oldm = misc.getmetrics()
local table_of_strings = {}
for i = 3000, 4000 do table.insert(table_of_strings, tostring(i)) end
for i = 3900, 4100 do table.insert(table_of_strings, tostring(i)) end
local newm = misc.getmetrics()
print("gc_strnum diff = " .. newm.gc_strnum - oldm.gc_strnum)
print("strhash_miss diff = " .. newm.strhash_miss - oldm.strhash_miss)
print("strhash_hit diff = " .. newm.strhash_hit - oldm.strhash_hit)
end
f()
The result will probably be: "gc_strnum diff = 1100" because we added 1202 strings but 101 were duplicates, "strhash_miss_diff = 1100" for the same reason, "strhash_hit_diff = 101" plus some overhead, for the same reason. (There is always a slight overhead amount for ``strhash_hit``, which can be ignored.)
Вероятный результат --- ``gc_strnum diff = 1101``, так как мы добавили 1202 строки, 101 из которых были дубликатами. По той же причине ``strhash_miss = 1101``, а ``strhash_hit = 101`` плюс некоторые издержки. (``strhash_hit`` всегда предполагает небольшие издержки, которые можно игнорировать.)
We say "probably" because there is a chance that the strings were already allocated somewhere. It is a good thing if the slope curve of ``strhash_miss`` is less than the slope curve of ``strhash_hit``.
Результат лишь вероятный, поскольку память для строк могла быть выделена ранее. Хорошо, если кривая наклона ``strhash_miss`` менее крутая, чем у ``strhash_hit``.
The other ``gc_*num`` values -- ``gc_cdatanum``, ``gc_tabnum``, ``gc_udatanum`` -- can be accessed in a similar way. Any of the ``gc_*num`` values can be useful when looking for memory leaks – the total number of these objects should not grow nonstop. A more general way to look for memory leaks is to watch ``gc_total``. Also ``jit_mcode_size`` can be used to watch the amount of allocated memory for machine code traces.
Доступ к остальным значениям ``gc_*num`` --- ``gc_cdatanum``, ``gc_tabnum`` и ``gc_udatanum`` можно получить аналогичным образом. Любое значение ``gc_*num`` поможет при поиске утечки памяти: общее количество этих объектов не должно постоянно расти. Более общий способ искать утечки памяти --- наблюдать за переменной ``gc_total``. Также можно отслеживать значение ``jit_mcode_size``, отражающее объем памяти, выделенной для трасс машинного кода.
Example with gc_allocated and gc_freed
Пример с gc_allocated и gc_freed
To track an application's effect on the garbage collector (less is better):
Чем меньше работает сборщик мусора, тем лучше. Отслеживать, насколько его нагружает приложение, можно так:
function f()
for i = 1, 10 do collectgarbage("collect") end
local oldm = misc.getmetrics()
local newm = misc.getmetrics()
oldm = misc.getmetrics()
collectgarbage("collect")
newm = misc.getmetrics()
print("gc_allocated diff = " .. newm.gc_allocated - oldm.gc_allocated)
print("gc_freed diff = " .. newm.gc_freed - oldm.gc_freed)
end
f()
function f()
for i = 1, 10 do collectgarbage("collect") end
local oldm = misc.getmetrics()
local newm = misc.getmetrics()
oldm = misc.getmetrics()
collectgarbage("collect")
newm = misc.getmetrics()
print("gc_allocated diff = " .. newm.gc_allocated - oldm.gc_allocated)
print("gc_freed diff = " .. newm.gc_freed - oldm.gc_freed)
end
f()
The result will be: ``gc_allocated diff = 800``, ``gc_freed diff = 800``. This shows that ``local ... = getmetrics()`` itself causes memory allocation (because it is creating a table and assigning to it), and shows that when the name of a variable (in this case the ``oldm`` variable) is used again, that causes freeing. Ordinarily the freeing would not occur immediately, but ``collectgarbage("collect")`` forces it to happen so we can see the effect.
Результат: ``gc_allocated diff = 800``, ``gc_freed diff = 800``. Отсюда видно, что строка ``local ... = getmetrics()`` вызывает аллокацию памяти, поскольку создает таблицу и наполняет ее значениями. Когда имя переменной (в данном случае ``oldm``) используется повторно, память освобождается. Обычно это происходит не сразу, однако ``collectgarbage("collect")`` принудительно запускает сборку мусора, благодаря чему можно немедленно увидеть результат.
Example with gc_allocated and a space optimization
Пример с gc_allocated и оптимизацией по памяти
To test whether optimizing for space is possible with tables:
Этот пример показывает, что можно оптимизировать расход памяти для таблиц.
function f()
collectgarbage("collect")
local oldm = misc.getmetrics()
local t = {}
for i = 1, 513 do
t[i] = i
end
local newm = misc.getmetrics()
local diff = newm.gc_allocated - oldm.gc_allocated
print("diff = " .. diff)
end
f()
function f()
collectgarbage("collect")
local oldm = misc.getmetrics()
local t = {}
for i = 1, 513 do
t[i] = i
end
local newm = misc.getmetrics()
local diff = newm.gc_allocated - oldm.gc_allocated
print("diff = " .. diff)
end
f()

Loading…

User avatar None

String updated in the repository

testing_project / Documentation: reference/tooling/luajit_getmetrics — Russian

Go through the :ref:`C stored procedures <f_c_tutorial-c_stored_procedures>` tutorial. Replace the easy.c example with
В руководстве Tarantool по :ref:`хранимым процедурам на языке C <f_c_tutorial-c_stored_procedures>` перейдите к примеру с файлом ``easy.c``. Удалите содержимое файла и вставьте следующий код:
a year ago
Browse all string changes

Things to check

Mismatched colon 1

Source and translation do not both end with a colon

Reset

Glossary

English Russian
No related strings found in the glossary.

String information

String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
locale/ru/LC_MESSAGES/reference/tooling/luajit_getmetrics.po, string 64