Changes for page Determining cause of log entry
Last modified by Erik Bakker on 2024/02/22 12:35
From version 6.1
edited by Erik Bakker
on 2022/06/23 15:33
on 2022/06/23 15:33
Change comment:
There is no comment for this version
To version 2.1
edited by Erik Bakker
on 2022/06/13 11:24
on 2022/06/13 11:24
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - Determiningcauseof log entry1 +Monitoring API Gateway statistics - Parent
-
... ... @@ -1,1 +1,1 @@ 1 -Main.eMagiz Academy.Microlearnings.Advanced Level.Advanced monitoring.WebHome 1 +Main.eMagiz Academy.Microlearnings.Advanced Level.Advanced monitoring API Gateway.WebHome - Content
-
... ... @@ -1,56 +1,75 @@ 1 1 {{container}}{{container layoutStyle="columns"}}((( 2 - Whensomething goes wrongwithintheprocess, youwantto determinewhatcausedthe error to beraised. In earliermicrolearnings, we learned howtodetermine thecauseof error messages. Now,weshiftour focusto thelog entries. IneMagiz, errorsanshowup in thedashboardand thelogentries. Forhis microlearning,wewill lookat thelog entries andsee how we can use thatinformation tolookattheflow to determinewhatpartofthe flowis causingtheerror.2 +In your API Gateway solution, it is important to be able to review the API Gateway statistics. These statistics are available in Generation 3 based runtimes, and available via the Manage phase -> Monitoring Gen3 3 3 4 4 Should you have any questions, please get in touch with academy@emagiz.com. 5 5 6 +* Last update: March 17th, 2022 7 +* Required reading time: 5 minutes 8 + 6 6 == 1. Prerequisites == 7 7 * Advanced knowledge of the eMagiz platform 8 -* Errors inthe logthat canbeanalyzed11 +* Complete relevant API Gateway microlearnings from Crash course to Intermediate 9 9 10 10 == 2. Key concepts == 11 -This microlearning centers around determining the cause of log entry 12 -By determining the cause, we mean: Figuring out what was responsible for generating an error. 14 +The API Gateway statistics are geared towards understanding the level of interaction between the API callers and the webservice of the API gateway. With the objective to understand the bredth and depth of the usage of the operations published 13 13 14 -* The component that raises the error could differ from the component that causes the error 15 -* A log entry error could be raised on runtime level or flow level but can be related to a specific part of the process 16 16 17 -== 3. Determining the cause of log entry == 18 18 19 -When something goes wrong within the process, you want to determine what caused the error to be raised. In earlier microlearnings, we learned how to determine the cause of error messages. Now, we shift our focus to the log entries. In eMagiz, errors can show up in the dashboard and the log entries. For this microlearning, we will look at the log entries and see how we can use that information to look at the flow to determine what part of the flow is causing the error. 18 + 19 +== 3. API gateway statistics == 20 20 21 -* The component that raises the error could differ from the component that causes the error 22 -* A log entry error could be raised on runtime level or flow level but can be related to a specific part of the process 21 +Navigate to the Manage phase and select Monitoring Gen3. On the left hand side select API Management Statistics which opens a page as below. Ensure to select for what environment you want to see these statics 23 23 24 - In eMagiz, you can find the logntries underManage-> Log entries.Here youcan focus yoursearch by searching for a specific runtime.Anexampleofan error thatcould beraisedand shownnthe log entries is any errorintroduced in the entry that causesthe transactionto fail.23 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-1.png]] 25 25 26 -[[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--example-error-log-entry.png]] 25 +=== 3.1 API Requests === 26 +This section displays the total number of requests made to the API Gateway. Can be valuable to understand if in a give timeframe requests are made or not. It contains all the requests * other sections will illustrate which requests more specifically. 27 27 28 - When you have found the logntry,it becomestime toread it tosee whether you canterpret the problem. For example, in this case, we that a message has beenrejectedin a filter component. When we readon, we see the name of the specific filter componentthathrowingthe error.28 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-7.png]] 29 29 30 -[[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--example-error-log-entry-identify-the-problem.png]] 30 +=== 3.2 Static resource request === 31 +This shows the number of request made by the SwaggerUI which is considered a static resource. This can help to understand how often that SwaggerUI is used. 31 31 32 -Now that we know the component that raised the error, we can navigate to the flow in which this component is used. You can determine based on the naming, but the flow's name is also shown on the log entry if it is known. 33 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-8.png]] 34 + 35 +=== 3.3 Status per user === 36 +This displays per application user what the HTTP response codes where. Based on that response code insight is provided around the behavior of that user such as unauthorized requests. Users are identified by part of their access credential (first part of API key or Client ID). 33 33 34 -[[image:Main.Images.Microlearning.WebHome@advanced- active-monitoring-determining-cause-of-log-entry--example-error-log-entry-find-flow.png]]38 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-6.png]] 35 35 36 -When we navigate to the flow that is raising the error in our example, we see that a filter is in the flow that checks before the message can be further processed by eMagiz. 40 +=== 3.4 Resources per user === 41 +This displays per applciation user what resources are specifically used by that user. The colors indicate the resource which are listed as legend to the graph. By selecting a resource in the legend, you can toggle that resource to not display. The graph shows the total number of requests made. 37 37 38 -[[image:Main.Images.Microlearning.WebHome@advanced- active-monitoring-determining-cause-of-log-entry--example-error-log-entry-analyze-flow.png]]43 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-5.png]] 39 39 40 -When we open the filter, we can see what check is done. By analyzing the check, we can determine whether the statement itself is faulty, a configuration error occurred, or whether input created earlier in the flow was the culprit in this case. For this example, we used an obvious error to make the problem clear to you. In real-life scenarios identifying the cause might take some additional work to determine the specific reason for your particular problem. 45 +=== 3.5 Status per resource === 46 +This display shows the HTTP response codes for every resource/operation available. Could help to understand the health and/or the validity of the operation for the application users. 41 41 42 -[[image:Main.Images.Microlearning.WebHome@advanced-active-monitoring-determining-cause-of-log-entry--current-faulty-check.png]] 48 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-2.png]] 49 + 50 +=== 3.7 Methods per resource === 51 +Shows what HTTP methods are used for every resource/operation 43 43 53 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-3.png]] 54 + 55 +=== 3.8 Status for status resource / methods per static resource === 56 +Shows the HTTP response codes and what HTTP methods are used by the Swagger UI 57 + 58 +[[image:Main.Images.Microlearning.WebHome@advanced-monitoring-apigateway-statistics-4.png]] 59 + 60 + 61 + 44 44 == 4. Assignment == 45 45 46 - Searchfor problems inhelogand seeifyoucanfindoutwhatcaused theseproblems.Thisassignmentcanbeompleted withthehelpofthe(Academy) project thatyouhavecreated/usedintheprevious assignment.64 +Take a moment to review your API Gateway solution and find the Manage * Montoring section to see the API management metrics. Review if you can understand these values 47 47 48 48 == 5. Key takeaways == 49 49 50 -* The log entry shows which flow has raised the error 51 -* You need to read the log entry to interpret on which component the error is raised 52 -* With the information from the log entry, you can analyze the flow starting at the component that raised the error and move back in the process step by step 68 +* The API Management statistics are geared towards understanding the actual use of the API gateway. 69 +* That insight is handy to understand who does what and how often. Yet can also be used for trouble shooting. 53 53 71 + 72 + 54 54 == 6. Suggested Additional Readings == 55 55 56 56 If you are interested in this topic and want more information, please read the release notes provided by eMagiz. ... ... @@ -57,6 +57,4 @@ 57 57 58 58 == 7. Silent demonstration video == 59 59 60 -This video demonstrates a working solution and how you can validate whether you have successfully completed the assignment. 61 - 62 -{{video attachment="advanced-active-monitoring-determining-cause-of-log-entry.mp4" reference="Main.Videos.Microlearning.WebHome"/}})))((({{toc/}}))){{/container}}{{/container}} 79 +As this is a more theoretical microlearning, we have no video that accompanies this microlearning.)))((({{toc/}}))){{/container}}{{/container}}