----

Relog

Сохраняет данные счетчиков производительности из файлов журналов в файлы других форматов, такие как текстовый-TSV(разделитель табуляция), текстовый-CSV(разделитель запятая), двоичный-BINили SQL.

Синтаксис

relog [имя_файла [имя_файла...]] [-a] [ -c путь [путь...]] [-cfимя_файла] [-f {bin|csv|tsv|SQL}] [-tзначение] [-o {файл_вывода| DSN!журнал_счетчиков}] [-bМ/д/гггг [[чч:]мм:]сс] [-eМ/д/гггг[[чч:]мм:]сс] [-config имя_файла] [-q]

Параметры

имя_файла[имя_файла ...]

Указывает путь к существующему журналу счетчиков производительности. Можно указать несколько файлов ввода.

-a

Производит запись в конец файла вывода, вместо перезаписи. Этот параметр не применяется для формата SQL, где по умолчанию установлен режим записи в конец.

-cпуть[путь ...]

Указывает путь к журналу счетчиков производительности. Чтобы указать несколько путей, разделите их пробелом и заключите в кавычки (например, "Путь1 Путь2").

-cfимя_файла

Указывает путь к текстовому файлу, в котором перечислены счетчики производительности, которые следует включить в файл журнала. Этот ключ используется для перечисления путей к счетчикам во входном файле друг за другом. По умолчанию все счетчики из исходного файла журнала загружаются повторно.

-f {bin|csv|tsv|SQL}

Указывает путь к формату выходного файла. По умолчанию используется двоичный формат (bin). Для баз данных SQL, выходной файл определяет DSN!журнал_счетчиков. Имеется возможность указать расположение базы данных, используя диспетчер ODBC для настройки DSN.

-tзначение

Указывает интервалы обновления через каждые "n" записей. Каждая n-ая запись добавляется в файл журнала. По умолчанию добавляются все записи.

-o{выходной_файл| DSN!журнал_счетчиков}

Указывает путь к выходному файлу или базе данных SQL, где счетчики будут записаны.

-b М/д/ггггчч[:мм[:сс]]

Указывает время начала копирования первой записи из входного файла. Дату и время необходимо вводить в следующем формате М/д/ггггчч:мм:сс.

-e М/д/ггггчч[:мм[:сс]]

Указывает время окончания копирования последней записи из входного файла. Дату и время необходимо вводить в следующем формате М/д/ггггчч:мм:сс.

-configимя_файла

Задает путь к файлу, содержащему параметры командной строки.

-q

Отображает счетчики производительности и временные диапазоны файлов журнала, указанные во входном файле.

/?

Отображает справку в командной строке.

Примечания

• Формат пути счетчика

  Общий формат для путей счетчиков выглядит следующим образом: [\\компьютер]\объект[родительский_объект/экземпляр#индекс]\счетчик], где:

  Компоненты «родительский_объект», «экземпляр», «индекс» и «счетчик» могут содержать допустимое имя или подстановочный знак. Компоненты «компьютер», «родительский_объект», «экземпляр» и «индекс» не являются необходимыми для всех счетчиков.

  Путь к счетчику определяется для каждого счетчика отдельно. Например, объект логический_дискимеет кодэкземпляра, поэтому для него необходимо задать значение #индексили ввести подстановочный знак. Таким образом, можно использовать следующий формат.

  \логический_диск(*/*#*)\*

  Для объекта процессне требуется задавать индексэкземпляра. Таким образом, можно использовать следующий формат.

  \процесс(*)\ID_процесса

  Ниже приведен список допустимых форматов.

  • \\компьютер\объект(родительский_объект/экземпляр#индекс)\счетчик
  • \\компьютер\объект(родительский_объект/экземпляр)\счетчик
  • \\компьютер\объект(экземпляр#индекс)\счетчик
  • \\компьютер\объект(экземпляр)\счетчик
  • \\компьютер\объект\счетчик
  • \объект(родительский_объект/экземпляр#индекс)\счетчик
  • \объект(родительский_объект/экземпляр)\счетчик
  • \объект(экземпляр#индекс)\счетчик
  • \объект(экземпляр)\счетчик
  • \объект\счетчик

  Если подстановочный знак используется в имени родительского объекта, будут возвращены все экземпляры указанного объекта, соответствующие заданным полям «экземпляр» и «счетчик».

  Если подстановочный знак используется в имени экземпляра, будут возвращены все экземпляры указанного объекта и родительского объекта, если имена всех экземпляров, соответствующих указанному коду, соответствуют подстановочному знаку.

  Если подстановочный знак используется в имени счетчика, будут возвращены все счетчики указанного объекта.

  Частичное совпадение пути счетчика (например «pro*») не поддерживается.

• Файлы счетчика

  Файлы счетчика это текстовые файлы, в которых перечислены один или более счетчиков производительности в существующем журнале. Полное имя счетчика копируется из журнала или результата выполнения ключа -qв формате [\\компьютер\ объект[экземпляр] \ счетчик]. Пути счетчиков отображаются по одному в строке.

• Копирование счетчиков

  При выполнении команды Relog производится копирование указанных счетчиков из каждой записи входного файла, производится преобразование формата, если необходимо. Разрешается использовать подстановочные пути в файле счетчика.

• Сохранение подкаталогов входных файлов

  С помощью ключа -tможно производить вставку входных файлов в выходные через каждую n-ую запись. По умолчанию данные загружаются повторно из каждой записи.

• Использование -b и -e ключей с файлами журнала.

  Имеется возможность указать, что выходные журналы будут включать записи до времени начала (параметр -b), чтобы обеспечить данные для счетчиков, которым требуются промежуточные значения форматируемых значений. В выходном файле будут содержаться последние записи из входного файла со штампом времени, более ранним, чем время завершения в параметре -e.

• Использование параметра -config

  Содержимое файла настроек, используемого с параметром -config, должно иметь следующий формат:

  [параметр_команды]

  значение

  где параметр_команды  параметр командной строки, а значение  его значение. Например:

  [o]

  output.txt

  [f]

  csv

  [t]

  5

Примеры

Чтобы обновлять существующие журналы трассировки через фиксированные интервалы в 30 записей, перечислять пути счетчиков, выходные файлы и форматы, введите следующую команду.

Relog c:\perflogs\daily_trace_log.blg -cf counter_file.txt -o c:\perflogs\reduced_log.csv -t 30 -f csv

Чтобы обновлять существующие журналы трассировки через фиксированные интервалы в 30 записей, перечислять пути счетчиков и выходные файлы, введите следующую команду.

Relog c:\perflogs\daily_trace_log.blg -cf counter_file.txt -o c:\perflogs\reduced_log.blg -t 30

Для вопросов, обсуждений, замечаний, предложений и т. п. можете использовать раздел форума этого сайта (требуется регистрация).



Новый раздел о средствах командной строки в рамках этого же проекта расположен здесь