# mms-pip
Public Python module from the GDWH-Team of MediaMarktSaturn-Technology.
```
pip install mms-pip
```
Topics:
1. gcp_logger
2. redis_handler
3. bq_handler
4. gcs_handler
## 1. gcp_logger
Log Module for standardized log purposes.
### How to use:
#### 1.1 Import module:
```python
from mms.gcp_logger import Logger
```
#### 1.2 Initalize the logger:
```python
# Cloud Function Logging:
logger = Logger(run_id, project_id, function_name, resource_type)
logger = Logger(run_id='lksjdf2', project_id='my-project-id', function_name='ppx-price-updates-de-gcs-bq', resource_type='cloud_function')
# App Engine Logging:
logger = Logger(run_id, project_id, module_id, version_id, resource_type)
logger = Logger(run_id='lksjdfl98', project_id='v135-5683-alice-ksk-explore', module_id='app-flex-sample-service', version_id='v0.0.1', resource_type='gae_app')
# Compute Engine:
logger = Logger(run_id, project_id, resource_type)
logger = Logger(run_id='lksjdfl98', project_id='v135-5683-alice-ksk-explore', resource_type='gce_instance')
# Kubernetes Engine:
logger = Logger(run_id, project_id, cluster_name, container_name, location, namespace_name, resource_type)
logger = Logger(run_id='id12345', project_id='v135-5683-alice-ksk-explore', cluster_name='jg-k8-testcluster', container_name=CONTAINER_NAME, location=ZONE, namespace_name='default', resource_type='k8s_container')
```
The following resource_types are supported:
Cloud Function: 'cloud_function'
App Engine: 'gae_app'
Compute Engine: 'gce_instance'
Kubernetes: 'k8s_container'
When resource type is unrecoginzable logs will be processed to 'Global'
#### 1.3 Use the logger:
```python
logger.info('your message')
logger.warning('your message')
logger.error('your message')
logger.critical('your message')
logger.debug('your message')
```
The logs are visible in Stackdriver Logging via GAE Application -> Module_id -> Version_id for App Engine.
Or under Cloudfunctions -> Function_id
Or under GCE VM Instance -> Instance_id
Or under Kubernetes Container -> cluster_name -> namespace_name -> container_name
### Important
This log tool only works in App Engine Standard/Flexible, Cloud Function, Compute Engine and Kubernetes environment.
For local testing do not initialize the logger as it would ran into errors because of the missing GCP context. (TODO)
### How we log
We initialize the logger only in the "app.py" file. From there every log entry will be written - Modules used within app.py need to return the exceptions to the caller so
error etc. get logged at one central point within app.py.
## TODO
Adding description of redis_handler
***
Tobias Hoke - Josef Goppold - 20.05.2019
mms-pip-0.5.2.tar.gz （12个子文件） 
mms-pip-0.5.2 
PKG-INFO 4KB setup.cfg 38B mms_pip.egg-info PKG-INFO 4KB
requires.txt 42B SOURCES.txt 227B top_level.txt 4B dependency_links.txt 1B setup.py 777B mms gcp_logger.py 4KB __init__.py 27B redis_handler.py 982B README.md 3KB资源评论
