Share
Jag kommer ihåg att arbeta på en Rails-app för några år sedan och någon flöt tanken på att använda den nya tjänsten som hade dykt upp på scenen. Det heter New Relic och de lovade att ge dig mer inblick i resultatet av din Rails app, än vad du någonsin kunde få förut. Vi gav det ett försök och det var imponerande, det var viktigare att det var något som Ruby webbutvecklingsekosystem verkligen behövde.
Sponsrat innehållDet här innehållet beställdes av New Relic och skrevs och / eller redigerades av Tuts + -laget. Vårt mål med sponsrat innehåll är att publicera relevanta och objektiva handledningar, fallstudier och inspirerande intervjuer som erbjuder genuint pedagogiskt värde till våra läsare och gör det möjligt för oss att finansiera skapandet av mer användbart innehåll.
Snabbspolning fram till nu och du skulle vara hårt pressad för att hitta en Ruby-webbapplikation som inte har New Relic ansluten. New Relic som ett företag har fortsatt att tillhandahålla verktyg för att övervaka dina Ruby-appar, men de har också förgrenat sig ut på ett antal andra språk som Java, Python och även .Net. Men självklart som antalet funktioner du ger växer gör det också komplexiteten och mängden dokumentation där ute. Det blir svårt att ta reda på var du ska börja, speciellt om du inte är expert än.
Idag trodde jag att vi kunde gå tillbaka till rötterna till New Relic och titta på hur vi kan komma igång med tjänsten för att övervaka en Rails applikation.
För att kunna använda New Relic behöver vi något att övervaka, så låt oss skapa en grundläggande "Hello World" Rails-app.
Appen vi skapar kommer att leva under ~ / Projects / tmp / newrelic, och kommer att kallas newrelic_rails1. Jag antar att du redan har installerat Rails:
cd ~ / projekt / tmp / newrelic rails nya newrelic_rails1 cd newrelic_rails1
Det finns inte mycket för oss att göra för att skapa vår "Hello World" -app. Vi behöver en ny controller:
skenor g kontroller hej
Nu behöver vi bara en rutt, vi kommer att få ruttvägen för applikationen att använda vår controller. Vi behöver också en vy med orden "Hello World". Med tanke på allt detta, vårt config / routes.rb ska se så här ut:
NewrelicRails1 :: Application.routes.draw do root 'hej # index' slutet
Vår controller (app / styrenheten / hello_controller.rb), kommer att vara enligt följande:
klass HelloController> ApplicationController def index slutänden
Och vår åsikt (app / vyer / hello / index.html.erb), kommer att likna:
Hej världen!
Vi kan nu starta vår utvecklingsserver:
skenor s
När vi krulla localhost: 3000, vi får:
...Hej världen!
Allting fungerar!
Med Ruby är det väldigt enkelt. Vi lägger till en pärla i vår Gemfile, springa a buntinstallation, släpp en config-fil i config-mappen och vi har allt vi behöver. I själva verket är New Relic ganska bra att styra dig igenom detta. Allt du behöver göra är att logga in på ditt konto och om du inte har använt ett New Relic-agent innan är det ganska uppenbart vad du ska göra:
För det första installerar vi New Gem agent-pärlan genom att lägga till den till vår Gemfile, enligt instruktionerna:
Vår Gemfile kommer nu att se ut så här:
källa 'https://rubygems.org' pärla 'skenor', '4.0.0' pärla 'sqlite3' pärla 'sass-rails', '~> 4.0.0' pärla 'uglifier', '> = 1.3.0' pärla "kaffebarar", "~> 4.0.0" pärla "jquery-rails" pärla "turbolinks" pärla "jbuilder", "~> 1.2" grupp: doc gör pärla sdoc ", kräver: false end pärla 'newrelic_rpm '
När vi lägger till någonting i Gemfile vi måste springa:
buntinstallation
Vi behöver också en newrelic.yml, som du kan ladda ner från New Relic:
Det kommer att bli förkonfigurerade med din licensnyckel. Vi måste lägga den här filen under config / newrelic.yml.
Vid denna tidpunkt om vi körde vår ansökan i scenografi eller produktionsläge skulle vi redan få data i vårt nya relikonto. Så låt oss göra det:
RAILS_ENV = produktionsskenor s
Den här gången när vi curl localhost: 3000, vi får:
NewrelicRails1 Hej världen!
Det finns en massa JavaScript som har infogats i våra sidor, så att New Relic kan övervaka webbläsartid. Det här är ett sätt att vi kan berätta att vår New Relic-integration fungerar. Men det är inte det enda sättet, skapar New Relic också en loggfil:
% cat log / newrelic_agent.log Loggfil skapad den 2013-09-22 16:23:13 +1000 av logger.rb / 36483 [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Starta New Relic Agent i "Production" miljö. [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: För att förhindra att agent startas lägger du till en NEWRELIC_ENABLE = falsk miljövariabel eller ändrar avsnittet "produktion" av din newrelic.yml. [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Läs konfiguration från config / newrelic.yml [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Aktivera begäran Sampler. [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Miljö: produktion [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Dispatcher: webrick [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Ansökan: Min ansökan [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Installera ActiveRecord 4 instrumentation [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Installera Net instrumentation [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Installera Uppskjuten Rack instrumentation [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Installera Rails 4 Controller instrumentation [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Installera Rails 4 visa instrumentation [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Installera Rails4 Felinstrumentering [09/22/13 16:23:13 +1000 skorks-envato ( 12424)] INFO: Färdig instrumentering [09/22/13 16:23:13 +1000 skorks-envato (12424)] INFO: Göra uppskjutet beroendeavkänning före rackstart [0 9/22/13 16:23:16 +1000 skorks-envato (12424)] INFO: Rapportering till: https://rpm.newrelic.com/accounts/303380/applications/2507356
Vi kan också kolla vårt New Relic-konto för att se till att en ny applikation har dykt upp för övervakning:
Det finns dock några saker som inte är så trevliga:
Så låt oss titta på vårt newrelic.yml filen lite mer detaljerad för att se hur vi kan övervaka vår appprestanda precis som vi vill ha det.
Först och främst är New Relic-konfigurationsfilen mycket väl kommenterad och jag uppmuntrar dig att läsa kommentarerna för de olika konfigurationsparametrarna för att förstå vad alla gör.
För det andra är New Relic-konfigurationen miljömedveten och konfigurationen för alla miljöer definieras i den newrelic.yml fil, det här ligner mycket på hur Rails database.yml fil fungerar. Vi definierar en massa gemensamma konfigurationsvärden och överstyrar sedan de relevanta i de specifika miljöblocken, t ex:
Vanlig: & default_settings license_key: ''app_name: My Application monitor_mode: true ... utveckling: <<: *default_settings monitor_mode: false test: <<: *default_settings monitor_mode: false production: <<: *default_settings monitor_mode: true staging: <<: *default_settings monitor_mode: true
Vi kan omedelbart börja se hur vi kan fixa några av de punkter som vi höjde ovanför. Om vi inte vill starta vår app i produktionsläge när vi anpassar vår konfiguration är allt vi behöver göra det möjligt att övervaka i utvecklingsläget (vi måste komma ihåg att stänga av det när vi är nöjda med vår konfiguration eftersom vi inte vill att utvecklingsdata klotter upp vårt New Relic-konto).
utveckling: <<: *default_settings monitor_mode: true
Vi bör också åsidosätta vårt programnamn för varje miljö som vi har för att se till att de övervakas separat och ansökningsnamnet är meningsfullt:
Vanlig: & default_settings license_key: ''app_name: newrelic_rails1 monitor_mode: true ... utveckling: <<: *default_settings monitor_mode: true app_name: newrelic_rails1 (Development) test: <<: *default_settings monitor_mode: false app_name: newrelic_rails1 (Test) production: <<: *default_settings monitor_mode: true app_name: newrelic_rails1 (Production) staging: <<: *default_settings monitor_mode: true app_name: newrelic_rails1 (Staging)
Med just dessa konfigurations tweaks, när vi startar vår server i utvecklingsläge och curl localhost: 3000:
Vi följer nu vår applikation i utvecklingsläge och vårt appnamn är vad vi förväntar oss. Om din ansökan säger att den inte tar emot några data, ge den en minut, det tar lite tid för att data ska börja komma igenom.
Det näst mest intressanta (och ofta det mest förvirrande) konfigurationsvärdet är Apdex T-värdet. Till skillnad från de flesta andra konfigurationsparametrar lever det här värdet inte i newrelic.yml filen, men finns istället i inställningarna för programmet inom New Relic:
Om du vill tweak ditt Apdex T-värde måste du göra det här, men vad är den här parametern och vad är det rätta värdet att lägga in det? Tja, New Relic förklarar det på följande sätt:
Ditt programs Apdex T-värde är inställt på 0,5 sekunder. Det betyder att förfrågningar som svarar på mindre än 0,5 sekunder är tillfredsställande, svarar mellan 0,5 sekunder och 2,0 sekunder tolererar (t), och svar på mer än 2,0 sekunder är frustrerande (f).
I huvudsak använder New Relic Apdex-värdet för att mäta din ansökans hälsa vad gäller prestanda, så om flera av de begäranden som övervakas av New Relic tar längre tid än ditt Apdex-värde, kommer New Relic att överväga att din ansökan ska fungera dåligt och om du har ställt in varningar kommer du att meddela om det. I grund och botten måste du räkna ut hur snabbt du vill att varje serverförfrågan ska uppfyllas av din ansökan, så om du är okej med en backend-begäran om två sekunder kan du ställa in ditt Apdex-värde till 2,0, men om du behöver en svaret ska returneras inom 100 ms då bör du ställa in ditt Apdex-värde till 0,1.
Om du har en ny applikation kan du ställa in Apdex-värdet till den prestanda du önskar från din ansökan. Om din app är en befintlig, kan det hända att du har några mätvärden angående hur snabbt det ska / ska utföra, och du kan styras av det. Alla förfrågningar som servern uppfyller i mindre än Apdex T-värdet kommer att anses av New Relic vara bra. Alla förfrågningar uppfyllda inom Apdex * 4 sekunder kommer att anses tolerera (dvs användare kan tolerera det). Alla svar som tar längre tid än Apdex * 4 kommer att betraktas som frustrerande (frustrerade användare tenderar inte att hålla fast). Så sätt ditt Apdex T-värde på ett sådant sätt att du faktiskt får användbar information utifrån det, det verkliga värdet beror på din domän och vad du vill uppnå (vad gäller prestanda), det finns inget rätt eller fel svar.
Vi ställer in vårt Apdex T-värde till 100ms (0,1), eftersom allt vi har är en "Hello World" -app, och det ska kunna återge ett svar mycket snabbt (även i utvecklingsläge).
Det var lite roligt att det mesta av konfigurationen kommer från newrelic.yml fil men Apdex T-värdet finns i programinställningarna, så New Relic låter dig nu flytta alla konfigurationsvärden från YAML-filen till New Relic:
Fördelen med detta är att du inte behöver omfördela varje gång du vill anpassa dina konfigurationsvärden, så det är definitivt något värt att överväga. Vi kommer att hålla fast vid YAML-filen för nu.
Så vad är några av de andra användbara New Relic-parametrarna vi borde veta om?
Tja, det finns en uppsättning parametrar som hanterar loggfilen New Relic Agent:
log_level: info log_file_path: 'log' log_file_name: 'newrelic_agent.log'
Dessa har förnuftiga standardvärden, men om vi vill att loggfilen ska gå till en viss plats eller om vi vill se mer eller mindre information i filen, kan vi enkelt styra det här. Eftersom vi just skapar New Relic ställer vi in loggnivån till debug, för att se till att vi inte saknar någon viktig information (när vi distribuerar kanske vi vill ställa in den varna, eller ens fel).
Vi får nu en mängd information i loggfilen, som (om den läses noggrant) kan ge oss mycket insikter om hur New Relic fungerar:
Accentsconagua
