Как установить окно в крыше

Вы также можете проверить необходимую версию Ruby на основе конкретной версии агента Skylight, который вы используете. Для любопытных: наш CI в настоящее время тестирует эти версии. Ожидается, что промежуточные версии также будут работать.

Требования к серверу

Мы стремимся поддерживать все серверы * nix с помощью glibc 2.15+, а также FreeBSD и musl. Просто добавьте гем в свой Gemfile, добавьте конфигурацию, а затем разверните, как обычно. При желании вы также можете запустить агент локально в macOS для тестирования.

Агент отлично работает на Heroku. Никаких особых действий не требуется.

Установка агента

1. Посетите приложение Skylight, чтобы получить токен установки.

2. Добавьте Skylight к во все среды в вашем Gemfile.
3. Выполните следующие команды в среде разработки :
   

    установка пакета bundle exec skylight setup <токен установки> 

   Это автоматически сгенерирует ваш config / skylight.yml файл.

4. Разверните приложение в рабочей среде.

ВАЖНО:

Содержимое файла skylight.yml следует считать секретным, поэтому, если ваше приложение является открытым исходным кодом, вы не захотите фиксировать его в своем репо. См. Раздел Установка токенов аутентификации, чтобы узнать, как вместо этого установить переменную среды.

См. Информацию об отдельных установках ниже, чтобы узнать, как запустить агент в нужных вам средах.

Развертывание агента

После того, как вы запустите skylight setup , вам нужно будет передать конфигурацию на свой сервер. Для этого у вас есть два варианта:

1. Проверьте файл config / skylight.yml (который создается автоматически и включает необходимый токен авторизации) ИЛИ

2. Установите соответствующие переменные ENV на минимум SKYLIGHT_AUTHENTICATION . Смотрите ниже для получения дополнительной информации.

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

Heroku

В качестве альтернативы использованию файла config / skylight.yml вы можете установить токен аутентификации как переменную ENV в вашей конфигурации Heroku:

 heroku: установить SKYLIGHT_AUTHENTICATION = "<токен>" 

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

Для получения дополнительной информации об установке переменных конфигурации Heroku см. Раздел Конфигурация и переменные конфигурации в документации Heroku.

Конфигурация агента

Автоматически созданный файл конфигурации config / skylight.yml выглядит так:

 --- аутентификация: <токен аутентификации> 

Единственное, что вам нужно , чтобы установить , это токен аутентификации, но есть ряд других доступных параметров конфигурации.

Настройка переменных конфигурации

Добавьте дополнительные параметры конфигурации в файл config / skylight.yml . Этот файл конфигурации будет проанализирован как ERB, поэтому вы можете добавить дополнительную логику, если хотите.

В качестве альтернативы конфигурация может быть установлена ​​через переменные среды. Как правило, переменные ENV представляют собой версии YAML с заглавной буквы с префиксом SKYLIGHT_ .

См. Также: Конфигурация для конкретной среды

Общие параметры

Установка токенов аутентификации

Маркер аутентификации требуется для передачи данных обратно в службу Skylight.Вы можете найти свой токен аутентификации на странице настроек вашего приложения в разделе «Ваши приложения» или «Общие приложения».

 --- аутентификация: <токен аутентификации> 

Или установите переменную среды SKYLIGHT_AUTHENTICATION .

Игнорирование контрольных точек / конечных точек проверки работоспособности

Иногда конечная точка существует исключительно для вашего балансировщика нагрузки, чтобы определить, запущен ли ваш процесс Rails. Если вы хотите игнорировать эту конечную точку, вы можете установить игнорируемую конечную точку пульса / проверки работоспособности следующим образом:

 ignored_endpoints: - HeartbeatController # статус - StatusWorker 

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

Имя конечной точки можно найти в списке конечных точек на панели инструментов вашего приложения Skylight. Для действий Rails это будет ControllerName # action . Для рабочих это будет WorkerName . Для Sinatra это будет VERB path , а для Grape - это Module [VERB] path . Если вы не уверены, вы можете найти это имя в списке конечных точек Skylight.

В качестве альтернативы вы можете добавить переменную среды SKYLIGHT_IGNORED_ENDPOINTS .Например:

 SKYLIGHT_IGNORED_ENDPOINTS = HeartbeatController # статус, StatusWorker 

Вы не можете добавить имя конечной точки, используя подстановочный знак, например ControllerName # * . Обычно мы отговариваем людей игнорировать любые конечные точки, которые не являются конечными точками сердцебиения / проверки работоспособности, поскольку это может снизить полезность Skylight. Если вы не думаете, что конечная точка будет проблемой, но затем проигнорируете ее, вы не узнаете, что это вызывает проблему, пока не станет слишком поздно!

Файл журнала

Чтобы изменить расположение журнала Skylight:

 log_file: журнал / просвет.журнал 

Или установите переменную среды SKYLIGHT_LOG_FILE . По умолчанию журнал можно найти по адресу log / skylight.log с помощью Rails или STDOUT в противном случае.

Путь к сокету демона

Путь, по которому создается файл сокета для демона. Как правило, вам не нужно менять это. Однако, если вы используете монтирование NFS (скажем, с Vagrant), вам нужно указать это на расположение, отличное от NFS.

 daemon.sockdir_path: / var / run / myapp 

Отслеживание развертывания

Skylight позволяет вам видеть ваши развертывания, отмеченные на временной шкале отклика

Если вы развертываете репозиторий Git

Если вы развертываете репозиторий git, отслеживание развертывания должно быть Just Work ™ (на самом деле не зарегистрировано).Однако вы можете переопределить идентификатор развертывания по умолчанию, git sha и описания развертывания с помощью переменных конфигурации, как показано ниже.

Если вы используете Heroku

Вам может потребоваться включить функцию метаданных Heroku Dyno, чтобы отправлять информацию о развертывании в Skylight.

Ручная настройка

Если вы не развертываете репозиторий git (например, используете скрипт, который копирует файлы на сервер или не-git VCS), отслеживание развертывания не будет автоматизировано. Вместо этого вам нужно будет вручную настроить Skylight для отслеживания развертываний:

 развернуть: id: <% = some_code_that_returns_a_unique_id%> git_sha: <% = some_code_that_returns_the_sha%> описание: <% = some_code_that_returns_a_description%> 

В качестве альтернативы вы можете установить SKYLIGHT_DEPLOY_ID , SKYLIGHT_DEPLOY_GIT_SHA и SKYLIGHT_DEPLOY_DESCRIPTION в качестве переменных среды.

Профессиональный совет:

Если вы свяжете свое приложение с GitHub и предоставите действительный git sha, вы можете оставить описание пустым. Мы получим его на GitHub!

ВАЖНО:

Если вы переопределите одну из этих переменных, наш сервер будет считать, что все они переопределены. Например, если вы выполняете развертывание с помощью Heroku и переопределяете описания развертывания, вам также необходимо переопределить идентификатор развертывания и / или sha.

Настройка нескольких сред

По умолчанию агент Skylight активируется только в «производственной» среде.См. Страницу Среды, чтобы узнать, как включить Skylight в других средах.

Рельсы

Есть дополнительные параметры конфигурации, которые можно установить в среде Rails.

ВАЖНО:

Если не указано иное, эти настройки следует добавить в файл config / application.rb . Не пытайтесь установить их через инициализаторы, поскольку Skylight запускается до запуска инициализаторов.

Skylight выполняет настройку, когда требуется драгоценный камень, при этом Rails будет обнаружен и задействован.Однако вы можете обнаружить, что вам нужно вручную требовать skylight / railtie , если вам нужно загрузить драгоценный камень Skylight до Rails.

Регистратор

Возможно, вы захотите указать Skylight использовать определенный регистратор. Этого можно добиться так:

 config.skylight.logger = Logger.new (STDOUT) 

Зонды

Чтобы инструментировать другие библиотеки вне Rails, агент включает зонды, которые активируются только в том случае, если требуются связанные файлы.Полный список датчиков см. В разделе «Доступные варианты оборудования». Вы также можете узнать больше о том, как работают зонды.

Вы можете добавить дополнительные зонды в конфигурацию Rails:

 config.skylight.probes + =% w (excon redis active_model_serializers) 

В случае, если вы хотите отключить зонд, который включен по умолчанию, вы также можете удалить его из списка:

 config.skylight.probes - = ['промежуточное ПО'] 

Стек промежуточного программного обеспечения

По умолчанию Skylight располагается в верхней части стека промежуточного программного обеспечения.Вы можете проверить позицию Skylight в стеке промежуточного программного обеспечения, запустив промежуточное программное обеспечение rake . В том маловероятном случае, когда вам потребуется изменить это, вы можете потребовать Skylight в определенном месте в стеке промежуточного программного обеспечения:

 config.skylight.middleware_position = 0 config.skylight.middleware_position = {after: MiddlewareName} config.skylight.middleware_position = {before: MiddlewareName} 

Sinatra

В рельсах

Если ваше приложение Sinatra смонтировано в Rails, все, что вам нужно сделать, это потребовать правильные зонды:

 config.skylight.probes + =% w (продолжение sinatra tilt) 

См. Инструкции по настройке Rails для получения дополнительной информации.

Автономный

Skylight работает так же хорошо в автономных приложениях Sinatra, хотя инструкции немного сложнее.

Sinatra обычно не требуют наличия всех драгоценных камней в Gemfile, поэтому вам может потребоваться явное требование Skylight. Вам также потребуется явно загрузить агент Skylight. Обычно вы не хотите запускать Skylight в режиме разработки, поэтому вам нужно указать его использование в среде : production :

 configure: production do требуется "просвет / синатра" Небесный свет.старт! (файл: PATH_TO_CONFIG) конец 

PATH_TO_CONFIG должен указывать на ваш файл config / skylight.yml .

В качестве альтернативы, если вы устанавливаете свою конфигурацию с использованием переменных ENV, вы можете вызвать Skylight.start! без аргументов.

Вам не нужно устанавливать промежуточное ПО вручную или делать что-либо с настройками разветвления единорога.

Чтобы использовать датчики Skylight, они потребуются индивидуально:

 Мансардное окно.зонд (PROBE_NAME) 

Примечание:

Padrino в настоящее время не поддерживается, так как он существенно отличается от базовой Sinatra. Мы изучаем возможность добавления поддержки в будущих выпусках.

Если ваше приложение Sinatra смонтировано в другом приложении Rack, и вы хотите включить префикс пути этого приложения в имя конечной точки Sinatra, установите SKYLIGHT_SINATRA_ROUTE_PREFIXES = true в вашем env или sinatra_route_prefixes: true в вашем просвете.yml (для любопытных это добавит значение SCRIPT_NAME к имени конечной точки вашего приложения Sinatra). (Требуется Skylight> = 4.2.0)

Виноград

На рельсах

Если ваше приложение Grape смонтировано в Rails, оно работает "из коробки" без дополнительной настройки! Поздравляю!

См. Инструкции по настройке Rails для получения дополнительной информации.

На Sinatra

Если ваше приложение Grape установлено в приложении Sinatra, просто следуйте инструкциям Sinatra.

Автономный

Grape обычно не требуют наличия всех драгоценных камней в Gemfile, поэтому вам может потребоваться явное требование Skylight. Вам также потребуется явно загрузить агент Skylight.

 требуется "просвет" Skylight.start! (Файл: PATH_TO_CONFIG) 

PATH_TO_CONFIG должен указывать на ваш файл config / skylight.yml .

В качестве альтернативы, если вы настраиваете свою конфигурацию с использованием переменных ENV, вы можете вызвать Skylight.Начало! без аргументов.

Наконец, вы хотите установить промежуточное ПО Skylight в свое базовое приложение Grape или Rack с:

Чтобы использовать датчики Skylight, они потребуются индивидуально:

 Skylight.probe (PROBE_NAME) 

ВАЖНО:

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

Восстановление токена приложения

Если ваш токен приложения мог быть скомпрометирован, вы можете повторно создать его на странице настроек, а затем перейти к настройкам вашего приложения.

После регенерации токена вам необходимо обновить рабочее приложение новым токеном.

Создание приложения вручную

В некоторых случаях вам может потребоваться настроить приложение в Skylight вручную (например, для использования агента Phoenix). Создание приложения вручную - это способ настройки приложения в Skylight без запуска пакета bundle exec skylight setup <токен установки> .

Перейдите к экрану настройки приложения и нажмите «Или создайте приложение вручную.»В нижней части страницы. Затем вы сможете ввести название своего нового приложения.

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

Затем вам нужно установить свой токен аутентификации.

Наконец, разверните свое приложение. После развертывания обязательно проверьте свою панель управления Skylight; вы должны начать видеть данные запроса в ближайшее время!

Мансардное окно | Начало работы

Краткое руководство, теория Skylight и многое другое, что вам нужно знать, чтобы начать работу со Skylight.

Быстрый старт

Во-первых, убедитесь, что ваше приложение соответствует требованиям для запуска Skylight. Если так, то ура! Продолжать.

1. Посетите приложение Skylight, чтобы получить токен установки.

2. Добавьте Skylight к всем средам в вашем Gemfile.
3. Выполните следующие команды в среде разработки :
   

    установка пакета bundle exec skylight setup <токен установки> 

   Это автоматически сгенерирует ваш config / skylight .yml файл.

4. Разверните приложение в рабочей среде.

ВАЖНО:

Содержимое файла skylight.yml следует считать секретным, поэтому, если ваше приложение является открытым исходным кодом, вы не захотите фиксировать его в своем репо. См. Раздел Установка токенов аутентификации, чтобы узнать, как вместо этого установить переменную среды.

См. Раздел «Расширенная настройка» для получения дополнительных сведений о настройке переменных среды, использовании пользовательской конфигурации, настройке нескольких сред и использовании Skylight в среде, отличной от Rails.

Обзор функций

Практические идеи

Skylight позволяет легко понять данные о производительности вашего приложения и действовать в соответствии с ними:

Панель инструментов приложения

Это панель управления приложением - первое, что вы увидите, войдя в Skylight. Панель управления дает вам общее представление о том, как работает ваше приложение, и служит отправной точкой для изучения деталей.

См. «Навигация по приложению», чтобы узнать больше.

Просмотр конечной точки

Endpoint View - это сердце и душа Skylight.Эта страница - это не просто красивый внешний вид, это конечный результат преобразования тысяч точек данных в полезную информацию, которую вы можете использовать для ускорения своего приложения.

См. «Навигация по конечной точке», чтобы узнать больше.

Тенденции

Наша функция тенденций преобразует ваши данные о производительности в еженедельный отчет, который поможет вам выявить замедления раньше, чем это сделают ваши клиенты.

Чтобы узнать больше, см. «Не отступая от курса».

Теория просвета

Ответы, а не данные

Вместо того, чтобы утомлять вас миллионом диаграмм и графиков, Skylight превращает данные о производительности в полезные аналитические данные, так что вы тратите меньше времени на диагностику и больше времени на улучшение.

Наш пользовательский интерфейс довольно приятный и приятный в использовании. Мы оптимизировали его, чтобы обеспечить максимальное понимание и минимум отвлекающих факторов. Мы очень много работаем, чтобы сделать пользовательский интерфейс Skylight доступным, считая, что предоставление большего количества данных - худший опыт, если он не может быть представлен правильно.

Мы сосредотачиваемся на функциях, которые действительно помогают вам улучшить ваше приложение, таких как Agony для определения приоритетов улучшений, предупреждения для выявления потенциальных ошибок кода и последовательности событий, чтобы определить, на что ваше приложение тратит больше всего времени.

Не пытайтесь понять, почему ваше приложение работает медленно. Получите ответы с Skylight.

Время истинного отклика

Время ответа вашего приложения отображается в нескольких местах в Skylight. В большинстве случаев мы говорим о числах одним из двух способов. «Проблемное» время ответа - это 95-й процентиль, тогда как «типичное» время ответа - это медиана (50-й процентиль).

Большинство инструментов показывают только средние значения, которые легко вычислить, но сами по себе их полезность ограничена.В Skylight мы также всегда показываем 95-й процентиль времени отклика. Хотя для определения этого требуется значительно больше вычислений на серверной части, это гораздо лучший показатель для определения реальной производительности.

Средние значения практически бесполезны, когда речь идет о производительности сети, а в худшем случае они фактически вводят в заблуждение. Для получения дополнительной информации см. Сообщение в блоге DHH «Проблема со средними значениями». Google, Twitter и GitHub (и это лишь некоторые из них) используют числа 95-го процентиля при отслеживании производительности.

Узнайте больше о подходе Skylight к процентилям в нашем блоге.

Агрегация и выборка

Большинство других инструментов профилирования полагаются на выборку, чтобы предоставить вам подробную информацию о конечных точках. Хотя это дает некоторую ценность, но не по каждому запросу. В зависимости от того, как часто выполняется выборка, весьма вероятно, что в ней будут пропущены всплески и необычное поведение.

В Skylight мы отслеживаем информацию по каждому запросу. Затем мы агрегируем данные, чтобы получить репрезентативную картину вашего приложения, отбрасывая только выбросы.Это означает, что ни один запрос не игнорируется, и мы можем дать вам полное и точное представление о вашем приложении.

Веб-страница не найдена на InspectApedia.com

.

Что делать, если ссылка на веб-страницу на InspectApedia.com приводит к ошибке страницы 404

Это так же просто, как ... ну, выбирая из 1, 2 или 3

1. Воспользуйтесь окном поиска InspectAPedia в правом верхнем углу нашей веб-страницы, найдите нужный текст или информацию, а затем просмотрите ссылки, которые возвращает наша пользовательская поисковая система Google
2. Отправьте нам электронное письмо напрямую с просьбой помочь в поиске информации, которую вы искали - просто воспользуйтесь ссылкой СВЯЗАТЬСЯ С НАМИ на любой из наших веб-страниц, включая эту, и мы ответим как можно скорее.
3. Используйте кнопку НАЗАД вашего веб-браузера или стрелку (обычно в верхнем левом углу экрана браузера рядом с окном, показывающим URL-адрес страницы, на которой вы находитесь), чтобы вернуться к предыдущей статье, которую вы просматривали. Если вы хотите, вы также можете отправить нам электронное письмо с этим именем или URL-адресом веб-страницы и сообщить нам, что не сработало и какая информация вам нужна.

   Если вы действительно хотите нам помочь, используйте в браузере кнопку НАЗАД, затем скопируйте URL-адрес веб-страницы, которую вы пытались загрузить, и используйте нашу ссылку СВЯЗАТЬСЯ С НАМИ (находится как вверху, так и внизу страницы), чтобы отправьте нам эту информацию по электронной почте, чтобы мы могли решить проблему.- Спасибо.

Приносим свои извинения за этот SNAFU и обещаем сделать все возможное, чтобы быстро ответить вам и исправить ошибку.

- Редактор, InspectApedia.com

Задайте вопрос или введите условия поиска в поле поиска InspectApedia чуть ниже.

Мы также предоставляем МАСТЕР-ИНДЕКС по этой теме, или вы можете попробовать верхнюю или нижнюю панель ПОИСКА как быстрый способ найти необходимую информацию.

Зеленые ссылки показывают, где вы находитесь. © Copyright 2017 InspectApedia.com, Все права защищены.

Смотрите также

• 
  Как поставить крышу на дом из пеноблоков
• 
  Как убрать сосульки с крыши многоэтажки
• 
  Как покрыть крышу металлочерепицей вальмовую
• 
  Как правильно крепить водостоки к крыше дома
• 
  Как крепить капельник на крыше
• 
  Рубероид как укладывать на крышу
• 
  Как увеличить угол наклона крыши пристройки
• 
  Как замерить крышу
• 
  Как починить шиферную крышу от протекания
• 
  Как устанавливаются снегозадержатели на крышу
• 
  Как ставить конек на крышу