Bij het ontwikkelen van een moderne toepassing moet logging bovenaan de prioriteitenlijst staan.<\/p>\n
Logging biedt een manier om je app zowel in ontwikkeling als in productie te visualiseren, wat transparantie en zichtbaarheid mogelijk maakt. Met goed gestructureerde logging kunnen moderne toepassingen gemakkelijker onderhouden worden, omdat we pro-actief points of failure en bottlenecks in de prestaties van onze app kunnen opsporen.<\/p>\n
Het Laravel framework wordt geleverd met een robuust loggingsysteem dat alle hindernissen die komen kijken bij het configureren van een goed gestructureerd loggingsysteem oplost. Dit nieuwe loggingsysteem dat in Laravel 6.5 ge\u00efntroduceerd wordt is krachtig, en we zullen het in dit artikel verkennen.<\/p>\n\n
Dit artikel zal de basisprincipes van Laravel logging verkennen en uitleggen waarom je Laravel logging in je volgende project zou moeten gebruiken. We zullen gestructureerd loggen en gecentraliseerd loggen uitgebreid bespreken. Bovendien zullen we leren hoe je Laravel logging kunt implementeren door een Todo toepassing te bouwen.<\/p>\n
Je zult meer uit dit artikel halen als je het volgende al onder de knie hebt:<\/p>\n
Laravel logging gaat over hoe Laravel logging, oftewel automatische probleemmelding, afhandelt met behulp van een viraal PHP logging systeem dat Monolog heet. Maar vanwege Laravel’s filosofie om populaire bestaande bibliotheken te gebruiken om verschillende frameworkfuncties uit te voeren, gebruikt Laravel Monolog voor al de loggingbehoeften.<\/p>\n
Monolog<\/a> is een zeer flexibele en populaire PHP loggingbibliotheek die we kunnen configureren om je logs naar bestanden, sockets, databases, en andere webdiensten te sturen. Monolog biedt een vertrouwde interface voor het schrijven van logs, van standaard tekstbestanden tot geavanceerde externe logbeheerdiensten. Laravel stelt Monolog typisch in om een standaard logging configuratiebestand te gebruiken.<\/p>\n Voor meer informatie over Monolog en zijn mogelijkheden kun je de offici\u00eble documentatie<\/a> raadplegen, want dat valt buiten het bereik van dit artikel.<\/p>\n Voor we duiken in het configureren en implementeren van Laravel logging met Monolog, verkennen we eerst meer redenen om Laravel logging te gebruiken en de verschillende soorten.<\/p>\n Waarom is logging nodig?<\/p>\n Het Twelve-Factor App<\/a> manifest behandelt logging als een van de belangrijkste aandachtspunten van een moderne toepassing, want logging is de sleutel tot prestaties en monitoring.<\/p>\n Logs<\/a> helpen bij het gedetailleerd begrijpen van fouten die in de productie optreden en waar ze vandaan komen. Met de juiste logstructuren kan bovendien de specifieke gebruiker getoond worden, de actie die de fout veroorzaakte, en de mogelijke oplossing voor snellere bug fix en onderhoud.<\/p>\n Gestructureerde logging is een redder in nood in productie-applicaties door te helpen bij het opsporen van defecten en het oplossen van problemen in de productie. Bovendien kun je al je logberichten in real-time volgen en verzamelen met gespecialiseerde logging tools voor live analyse en rapportage.<\/p>\n Om deze redenen moet je van gestructureerde logging een topprioriteit maken in je volgende moderne applicatieproject.<\/p>\n Laten we eens kijken naar het overzicht van de verschillende loggingstijlen die beschikbaar zijn.<\/p>\n Het leren van de basisprincipes van logging helpt je te begrijpen hoe Laravel met logging omgaat en hoe je je gestructureerde loggingpraktijken kunt verbeteren.<\/p>\n Laten we twee essenti\u00eble concepten in logging onderzoeken om beter te begrijpen hoe we onze loggingprocedures kunnen implementeren.<\/p>\n In softwareontwikkeling is gestructureerd loggen het implementeren van een vooraf bepaald en consistent berichtformat voor toepassingslogs. Met dit formaat kunnen de berichten behandeld worden als gegevens die veel beter gevolgd, gemanipuleerd en gevisualiseerd kunnen worden dan het gewone tekstformat.<\/p>\n Je moet een gestructureerde loggingaanpak implementeren in je moderne applicatieontwikkeling omdat logbestanden essentieel zijn voor ontwikkelaars als er in productie iets verkeerds gebeurt met je applicatie.<\/p>\n Omdat Laravel Monolog gebruikt, kunnen ontwikkelaars snel gestructureerd loggen implementeren door de logger te configureren om specifieke soorten informatie te ontvangen, de logbestanden in verschillende formaten op te slaan, en de logs naar verschillende externe logbeheerdiensten te sturen voor visualisatie.<\/p>\n Een gecentraliseerd logsysteem is een systeem waarbij logs vanuit meerdere bronnen naar Centralized Log Management (CLM) oplossingen worden gestuurd voor eenvoudige consolidatie en visualisatie. CLM is echter een gespecialiseerde loggeroplossing die logberichten uit verschillende bronnen verzamelt en de gegevens consolideert voor gemakkelijke verwerking en visualisatie.<\/p>\n Behalve het verzamelen van gegevens wordt van CLM ook verwacht dat het de analyse van loggegevens ondersteunt en een duidelijke presentatie van de gegevens na analyse.<\/p>\n Laten we eens kijken naar het verschil tussen gestructureerd loggen en basic (ongestructureerd) loggen en waarom je gestructureerd loggen in je Laravel project zou moeten gebruiken.<\/p>\n Bij basic loggen worden de logbestanden in een onbewerkt format opgeslagen met beperkte gegevens om individuele logs op te vragen en te identificeren.<\/p>\n Bij gebruik van Basic logging zullen ontwikkelaars<\/a> geen externe analysetools gebruiken om logs te lezen, bekijken en analyseren, tenzij ze een eigen tool ontwikkelen of het houden bij een tool die hun logformat ondersteunt.<\/p>\n Er zijn drie belangrijke redenen om het gebruik van basic logging te vermijden:<\/p>\n Gestructureerd loggen bespaart ontwikkelaars tijd door gebruik te maken van externe open-source loganalysetools die standaard log-structuur ondersteunen om logs te lezen, te bekijken en te analyseren.<\/p>\n Logs zijn nuttig als ze de juiste gegevens bevatten die hieronder vermeld staan, en dat is wat gestructureerd loggen probeert. We kunnen de gegevens in gestructureerde logging gebruiken om dashboards, grafieken, diagrammen en andere nuttige visualisaties te maken om de gezondheid van de toepassing te bepalen.<\/p>\n Dit zijn basisvoorbeelden van de informatie die we in gestructureerde logberichten kunnen opnemen. Bovendien kun je de gegevens helemaal aanpassen aan je eigen behoeften.<\/p>\n Hier zijn enkele voorbeelden van de gegevens die je met gestructureerde logging kunt verzamelen:<\/p>\n Logs moeten voldoende gegevens bevatten om de oplossing of de reden voor de loggebeurtenis gemakkelijk te kunnen visualiseren. Merk ook op dat je niet alle soorten informatie, zoals wachtwoorden of gevoelige gegevens, in logs moet opslaan.<\/p>\n Nu we een glimp opgevangen hebben van wat Laravel loggen inhoudt, gaan we verder met het implementeren van Laravel loggen door een toepassing te bouwen met loggen als belangrijke component.<\/p>\n Nu gaan we toepassen wat we tot nu toe geleerd hebben door een nieuw Laravel project te maken en Laravel logging te implementeren.<\/p>\n Als je Laravel nog niet eerder gebruikt hebt, kun je doorlezen wat Laravel is<\/a> of een blik werpen op onze lijst van uitstekende Laravel handleidingen<\/a> om aan de slag te gaan.<\/p>\n Eerst gaan we een verse Laravel instantie aanmaken met het onderstaande commando. Je kunt de offici\u00eble documentatie<\/a> raadplegen voor meer.<\/p>\n Open je console en navigeer naar de plaats waar je je PHP projecten opslaat voordat je de onderstaande commando’s uitvoert. Zorg ervoor dat Composer<\/a> correct ge\u00efnstalleerd en geconfigureerd is.<\/p>\n Vervolgens richten we onze database in, maken een nieuw Open je databaseprogramma en maak een nieuwe database aan. We doen hetzelfde met de naam Vervolgens voeren we het volgende commando uit om tegelijk de migratie en het Open de nieuw gemaakte migratie, die je kan vinden in database\/migrations\/xxx-create-todos-xxx.php<\/strong> en plak er de volgende codes in:<\/p>\n Je kunt je todo’s seeden met Faker gegevens door te leren je databases in Laravel te seeden<\/a> met Faker.<\/p>\n Met Laravel Monolog kun je gestructureerde logs streamen en versturen naar verschillende kanalen, zoals e-mails, Slack, bestanden, sockets, inboxen, databases, en verschillende webdiensten. In Laravel kun je het loggen configureren vanuit een enkel configuratiebestand dat staat in config\/logging.php<\/strong>.<\/p>\n Het configuratiebestand wordt geleverd met voorgedefinieerde log drivers om uit te kiezen, en de standaard driver is een Laravel biedt een handvol methoden<\/a> om met Logs te interageren, zoals binnenkort algemeen gedemonstreerd wordt in het TodosController.php<\/strong> controller bestand.<\/p>\n Open het pas gemaakte TodosController.php<\/strong> controller bestand dat je vindt app\/Http\/Controllers<\/strong> map en plak er de volgende codes in:<\/p>\n Binnen elk van de methoden in de Log fa\u00e7ade in de Stel dat je je niet op je gemak voelt met de standaard In dat geval kun je gemakkelijk een aangepast formatter object spinnen dat bij je gebruik past en het door de hele toepassing gebruiken.<\/p>\n De offici\u00eble Monolog documentatie geeft een complete lijst van beschikbare formatters<\/a> en je kunt er gemakkelijk een custom mee maken.<\/p>\nWaarom Laravel logging gebruiken?<\/h2>\n
Grondbeginselen van Laravel logging<\/h2>\n
Gestructureerd loggen in Laravel<\/h3>\n
Laravel gecentraliseerd loggen<\/h3>\n
Gestructureerd loggen vs. basic loggen<\/h3>\n
Basic loggen<\/h4>\n
\n
Gestructureerd loggen<\/h4>\n
\n
Hoe Laravel logging implementeren met Todo App<\/h2>\n
Laravel opzetten<\/h3>\n
composer create-project laravel\/laravel laravel-logging-app\ncd laravel-logging-app \/\/ Change directory to current Laravel installation\nphp artisan serve \/\/ Start Laravel development server<\/code><\/pre>\nDe database configureren en seeden<\/h3>\n
Todo<\/code> model, en seeden 200 nepgegevens om te testen.<\/p>\nlaravel_logging_app_db<\/code> en vullen dan ons .env<\/strong> bestand met de database-informatie:<\/p>\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_PORT=3306\nDB_DATABASE=laravel_logging_app_db\nDB_USERNAME=\/\/DB USERNAME HERE\nDB_PASSWORD=\/\/DB PASSWORD HERE<\/code><\/pre>\nTodo<\/code> model te maken:<\/p>\nphp artisan make:model Todo -mc<\/code><\/pre>\n<?php\nuse IlluminateSupportFacadesSchema;\nuse IlluminateDatabaseSchemaBlueprint;\nuse IlluminateDatabaseMigrationsMigration;\nclass CreateTodosTable extends Migration\n{\n \/**\n * Run the migrations.\n *\n * @return void\n *\/\n public function up()\n {\n Schema::create('todos', function (Blueprint $table) {\n $table->id();\n $table->string('title');\n $table->text('description')->nullable();\n $table->boolean('is_completed')->default(false);\n $table->timestamps();\n });\n }\n \/**\n * Reverse the migrations.\n *\n * @return void\n *\/\n public function down()\n {\n Schema::dropIfExists('todos');\n }\n}<\/code><\/pre>\nOverzicht van Monolog<\/h3>\n
stack<\/code> die het single<\/code> kanaal gebruikt om te loggen naar een laravel.log<\/strong> bestand dat in de map storage\/logs<\/strong> staat. We zullen gestructureerd loggen demonstreren door een paar van de Laravel log drivers<\/a> te gebruiken.<\/p>\nLogberichten schrijven in de controller<\/h3>\n
\n<?php\nnamespace AppHttpControllers;\nuse AppModelsTodo;\nuse IlluminateHttpRequest;\nuse AppHttpControllersController;\nuse IlluminateSupportFacadesAuth;\nuse IlluminateSupportFacadesLog;\nclass TodosController extends Controller\n{\n public function index(Request $request)\n {\n $todos = Todo::all();\n Log::warning('User is accessing all the Todos', ['user' => Auth::user()->id]);\n return view('dashboard')->with(['todos' => $todos]);\n }\n public function byUserId(Request $request)\n {\n $todos = Todo::where('user_id', Auth::user()->id)->get();\n Log::info('User is accessing all his todos', ['user' => Auth::user()->id]);\n return view('dashboard')->with(['todos' => $todos]);\n }\n public function show(Request $request, $id)\n {\n $todo = Todo::find($id);\n Log::info('User is accessing a single todo', ['user' => Auth::user()->id, 'todo' => $todo->id]);\n return view('show')->with(['todo' => $todo]);\n }\n public function update(Request $request, $id)\n {\n # Validations before updating\n $todo = Todo::where('user_id', Auth::user()->id)->where('id', $id)->first();\n Log::warning('Todo found for updating by user', ['user' => Auth::user()->id, 'todo' => $todo]);\n if ($todo) {\n $todo->title = $request->title;\n $todo->desc = $request->desc;\n $todo->status = $request->status == 'on' ? 1 : 0;\n if ($todo->save()) {\n Log::info('Todo updated by user successfully', ['user' => Auth::user()->id, 'todo' => $todo->id]);\n return view('show', ['todo' => $todo]);\n }\n Log::warning('Todo could not be updated caused by invalid todo data', ['user' => Auth::user()->id, 'todo' => $todo->id, 'data' => $request->except('password')]);\n return; \/\/ 422\n }\n Log::error('Todo not found by user', ['user' => Auth::user()->id, 'todo' => $id]);\n return; \/\/ 401\n }\n public function store(Request $request)\n {\n Log::warning('User is trying to create a single todo', ['user' => Auth::user()->id, 'data' => $request->except('password')]);\n # Validations before updating\n $todo = new Todo;\n $todo->title = $request->title;\n $todo->desc = $request->desc;\n $todo->user_id = Auth::user()->id;\n if ($todo->save()) {\n Log::info('User create a single todo successfully', ['user' => Auth::user()->id, 'todo' => $todo->id]);\n return view('show', ['todo' => $todo]);\n }\n Log::warning('Todo could not be created caused by invalid todo data', ['user' => Auth::user()->id, 'data' => $request->except('password')]);\n return; \/\/ 422\n }\n public function delete(Request $request, $id)\n {\n Log::warning('User is trying to delete a single todo', ['user' => Auth::user()->id, 'todo' => $id]);\n $todo = Todo::where('user_id', Auth::user()->id)->where('id', $id)->first();\n if ($todo) {\n Log::info('User deleted a single todo successfully', ['user' => Auth::user()->id, 'todo' => $id]);\n $todo->delete();\n return view('index');\n }\n Log::error('Todo not found by user for deleting', ['user' => Auth::user()->id, 'todo' => $id]);\n return; \/\/ 404\n }\n}<\/code><\/pre>\nTodoController<\/code>, voegden we de gevel Log<\/code> toe met een bepaald logniveau om het soort fout te bepalen dat we willen zenden. Hieronder zie je een voorbeeld van het gebruik van de<\/p>\nstore<\/code> methode.<\/p>\npublic function store(Request $request)\n{\n Log::warning('User is trying to create a single todo', ['user' => Auth::user()->id, 'data' => $request->except('password')]);\n # Validations before updating\n $todo = new Todo;\n $todo->title = $request->title;\n $todo->desc = $request->desc;\n $todo->user_id = Auth::user()->id;\n if ($todo->save()) {\n Log::info('User create a single todo successfully', ['user' => Auth::user()->id, 'todo' => $todo->id]);\n return view('show', ['todo' => $todo]);\n }\n Log::warning('Todo could not be created caused by invalid todo data', ['user' => Auth::user()->id, 'data' => $request->except('password')]);\n return; \/\/ 422\n}<\/code><\/pre>\nLogmeldingen opmaken<\/h3>\n
LineFormatter<\/code> die Laravel gebruikt, die prima werk levert met leesbare en behulpzame berichten.<\/p>\n