You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/build-your-software-catalog/sync-data-to-catalog/cloud-providers/aws/installations/live-events.md
+16-90Lines changed: 16 additions & 90 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,12 +11,7 @@ import Image from "@theme/IdealImage";
11
11
Port's AWS integration supports real-time event processing, allowing for accurate representation of your AWS infrastructure inside Port. This guide explains how to set up live events for your AWS resources.
@@ -184,93 +180,23 @@ Replace `"AWS::SSM::Parameter"` with the appropriate AWS resource type:
184
180
</TabItem>
185
181
</Tabs>
186
182
187
-
## Testing your setup
188
-
189
-
### Verify existing rules
190
-
191
-
If you have other live event rules (e.g., S3 Bucket sync), verify they're working:
192
-
193
-
1. Go to **EventBridge** → **Rules**.
194
-
2. Check that your rules are **Enabled**.
195
-
3. Look for any recent invocations in the **Metrics** tab.
196
-
197
-
### Test live events
198
-
199
-
1.**Trigger a test event**:
200
-
- Modify/create a resource (e.g., create an SSM Parameter).
201
-
- Update an existing resource.
202
-
- Delete a resource.
203
-
204
-
2.**Verify in Port**:
205
-
- Check your software catalog for real-time updates.
206
-
- Look for the resource changes in Port's interface.
207
-
208
-
### Example test for SSM parameters
209
-
210
-
1. Go to **Systems Manager** → **Parameter Store**
211
-
2. Create a new parameter:
212
-
- Name: `/test/my-parameter`
213
-
- Type: `String`
214
-
- Value: `test-value`
215
-
3. Check Port for the new parameter entity.
216
183
217
-
## Troubleshooting
184
+
## Supported AWS services
218
185
219
-
### Common issues
186
+
The complete list of AWS services that support live events can be found [here](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/supported-resources.html).
220
187
221
-
**Events not appearing in Port:**
222
-
- Verify the EventBridge rule is enabled
223
-
- Check that the API Gateway endpoint is correct
224
-
- Ensure the Port API key is valid
225
-
- Verify the input transformer mapping is correct
188
+
### Add other services
226
189
227
-
**Wrong resource type in Port:**
228
-
- Check the `resource_type` field in your input transformer template
229
-
- Ensure it matches the expected AWS resource type
190
+
To add live events for additional AWS services, follow these steps:
191
+
1. Identify the service's event source and detail type.
192
+
2. Create an EventBridge rule with the appropriate pattern.
193
+
3. Configure the input transformer with the correct resource type.
230
194
231
-
**Missing headers:**
232
-
- Verify both `Content-Type` and `x-port-aws-ocean-api-key` headers are set
233
-
- Check that the API key is the correct one for your Port environment
195
+
:::info Default Terraform installation
234
196
235
-
### Debugging Steps
236
-
237
-
1.**Check EventBridge Metrics**:
238
-
- Go to EventBridge → Rules → Your Rule → Metrics
239
-
- Look for successful invocations and any errors
240
-
241
-
2.**Check API Gateway Logs**:
242
-
- Go to API Gateway → Your API → Stages → production → Logs
243
-
- Look for incoming requests and any errors
244
-
245
-
3.**Verify Event Pattern**:
246
-
- Test your event pattern with sample events
247
-
- Use EventBridge's "Test pattern" feature
248
-
249
-
## Supported AWS Services
250
-
251
-
The following AWS services can be configured for live events:
252
-
253
-
| Service | Event Source | Detail Type | Resource Type |
0 commit comments