https://github.com/iopipe/iopipe-cli
Installer for IOpipe instrumentation using AWS Layers
https://github.com/iopipe/iopipe-cli
aws java lambda lambda-functions monitoring nodejs observability python serverless
Last synced: 5 months ago
JSON representation
Installer for IOpipe instrumentation using AWS Layers
- Host: GitHub
- URL: https://github.com/iopipe/iopipe-cli
- Owner: iopipe
- License: apache-2.0
- Created: 2019-01-11T02:53:05.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-10-11T01:30:56.000Z (over 5 years ago)
- Last Synced: 2024-11-29T14:49:05.201Z (6 months ago)
- Topics: aws, java, lambda, lambda-functions, monitoring, nodejs, observability, python, serverless
- Language: Python
- Homepage: https://www.iopipe.com/
- Size: 95.7 KB
- Stars: 3
- Watchers: 4
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Installer for IOpipe
Applies the IOpipe layers to functions in your
AWS account. Uses credentials as configured
for the AWS CLI.
## Runtimes supported
- Node.js 10
- Java 8
- Python 2.7
- Python 3.6
# Installation & configuration
On your system CLI:
```
pip3 install iopipe-cli
```
This tool assumes the AWS cli tool is configured correctly. Install and configure the AWS CLI as such:
```
pip3 install awscli --upgrade --user
```
Run the awscli configuration wizard:
```
aws configure
```
Refer to the [AWS CLI User Guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) for advanced configuration options and support for the aws cli tool.
# Installing IOpipe for functions with `iopipe`
The easiest way to update a function is to update it with
the AWS Lambda API:
```
iopipe lambda install --function --token
```
The token may also be passed by the CLI's environment variable, `IOPIPE_TOKEN`.
If your Lambda has been deployed by Cloudformation, this method will cause stack drift.
# Troubleshooting
## MacOS X: cannot find `iopipe` after installation
Make sure your python script bin directory is included in your path.
The [documentation for the AWS cli](https://docs.aws.amazon.com/cli/latest/userguide/install-macos.html#awscli-install-osx-path) covers
this topic and describes a solution.
## Error: Invalid value for "--token" / "-t": token invalid.
Your token may be malformed or corrupted. Try copying-and-pasting again, or using quotations on the cli.
Some users also report that they have the incorrect `jwt` library installed on their system. This project
uses the popular `pyjwt` module installable from PyPi.
## Error: `Unknown parameter in input: "Layers", must be one of: FunctionName, Role, Handler, Description, Timeout, MemorySize, VpcConfig, Environment, Runtime, DeadLetterConfig, KMSKeyArn, TracingConfig, RevisionId`
If you encounter this error, please update your boto3 dependency to the latest version.