Merge pull request #9 from Moesif/add-capture-outgoing-support

Add: Support for capturing outgoing requests

Author: dgilling

README.md

@@ -179,6 +179,37 @@ Type: `Boolean`
 
 `LOG_BODY` is default to true, set to false to remove logging request and response body to Moesif.
 
+#### __`CAPTURE_OUTGOING_REQUESTS`__
+Capture all outgoing API calls from your app to third parties like Stripe or to your own dependencies while using [Requests](http://docs.python-requests.org/en/master/) library. The options below is applied to outgoing API calls.
+When the request is outgoing, for options functions that take request and response as input arguments, the request and response objects passed in are [Requests](http://docs.python-requests.org/en/master/api/) request or response objects.
+
+```python
+from moesif_aws_lambda.middleware import *
+start_capture_outgoing(moesif_options) # moesif_options are the configuration options.
+```
+
+##### __`SKIP_OUTGOING`__
+(optional) _(req, res) => boolean_, a function that takes a [Requests](http://docs.python-requests.org/en/master/api/) request and response,
+and returns true if you want to skip this particular event.
+
+##### __`IDENTIFY_USER_OUTGOING`__
+(optional, but highly recommended) _(req, res) => string_, a function that takes [Requests](http://docs.python-requests.org/en/master/api/) request and response, and returns a string that is the user id used by your system. While Moesif tries to identify users automatically,
+but different frameworks and your implementation might be very different, it would be helpful and much more accurate to provide this function.
+
+##### __`IDENTIFY_COMPANY_OUTGOING`__
+(optional) _(req, res) => string_, a function that takes [Requests](http://docs.python-requests.org/en/master/api/) request and response, and returns a string that is the company id for this event.
+
+##### __`GET_METADATA_OUTGOING`__
+(optional) _(req, res) => dictionary_, a function that takes [Requests](http://docs.python-requests.org/en/master/api/) request and response, and
+returns a dictionary (must be able to be encoded into JSON). This allows
+to associate this event with custom metadata. For example, you may want to save a VM instance_id, a trace_id, or a tenant_id with the request.
+
+##### __`GET_SESSION_TOKEN_OUTGOING`__
+(optional) _(req, res) => string_, a function that takes [Requests](http://docs.python-requests.org/en/master/api/) request and response, and returns a string that is the session token for this event. Again, Moesif tries to get the session token automatically, but if you setup is very different from standard, this function will be very help for tying events together, and help you replay the events.
+
+##### __`LOG_BODY_OUTGOING`__
+(optional) _boolean_, default True, Set to False to remove logging request and response body.
+
 ## Update User
 
 ### Update A Single User

lambda_function.py

@@ -1,5 +1,7 @@
-from moesif_aws_lambda.middleware import MoesifLogger
+from moesif_aws_lambda.middleware import *
 import os
+import requests
+import json
 
 moesif_options = {
     'LOG_BODY': True,
@@ -8,6 +10,13 @@
 
 @MoesifLogger(moesif_options)
 def lambda_handler(event, context):
+
+    # Outgoing API call to third parties like Github / Stripe or to your own dependencies
+    start_capture_outgoing(moesif_options)
+    third_party = requests.get('https://httpbin.org/ip', json=json.dumps({'test': 2}),
+                               headers={"content-type": "text", "Authorization": "Bearer sdf4854wer"},
+                               auth=('Basic', "testauth"))
+
     return {
         'statusCode': 200,
         'isBase64Encoded': False,

moesif_aws_lambda/middleware.py

@@ -17,6 +17,18 @@
     from urllib import urlencode
 except ImportError:
     from urllib.parse import urlencode
+from moesifpythonrequest.start_capture.start_capture import StartCapture
+
+def start_capture_outgoing(moesif_options):
+    try:
+        if moesif_options.get('DEBUG', False):
+            print('Start capturing outgoing requests')
+        # Start capturing outgoing requests
+        moesif_options['APPLICATION_ID'] = os.environ["MOESIF_APPLICATION_ID"]
+        StartCapture().start_capture_outgoing(moesif_options)
+    except Exception as e:
+        print('Error while starting to capture the outgoing events')
+        print(e)
 
 # Initialized the client
 if os.environ["MOESIF_APPLICATION_ID"]:

requirements.txt

@@ -1,2 +1,3 @@
 moesifapi==1.3.2
 lambda_decorators==0.3.0
+moesifpythonrequest==0.2.0

setup.py

@@ -28,7 +28,7 @@
     # Versions should comply with PEP440.  For a discussion on single-sourcing
     # the version across setup.py and the project code, see
     # https://packaging.python.org/en/latest/single_source_version.html
-    version='1.0.6',
+    version='1.0.7',
 
     description='Moesif Middleware to automatically log API calls from AWS Lambda functions',
     long_description=long_description,
@@ -84,7 +84,7 @@
     # your project is installed. For an analysis of "install_requires" vs pip's
     # requirements files see:
     # https://packaging.python.org/en/latest/requirements.html
-    install_requires=['moesifapi', 'lambda_decorators'],
+    install_requires=['moesifapi', 'lambda_decorators', 'moesifpythonrequest'],
 
     # List additional groups of dependencies here (e.g. development
     # dependencies). You can install these using the following syntax,